Κουμπί περιστροφής (SpinButton) (Python) Marta Maria Casetti mmcasetti@gmail.com 2012 Ανάκτηση ακέραιου ή αριθμού κινητής υποδιαστολής από τον χρήστη. Ελληνική μεταφραστική ομάδα GNOME team@gnome.gr 2012-2015 Δημήτρης Σπίγγος dmtrs32@gmail.com 2012, 2013 Μαρία Θουκιδίδου marablack3@gmail.com 2014 Θάνος Τρυφωνίδης tomtryf@gmail.com 2014, 2015 SpinButton

Επιλέξτε έναν αριθμό, πληκτρολογώντας τον ή με κλικ στα κουμπιά -/+!

Ο χρησιμοποιούμενος κώδικας για παραγωγή αυτού παραδείγματος from gi.repository import Gtk import sys class MyWindow(Gtk.ApplicationWindow): def __init__(self, app): Gtk.Window.__init__(self, title="SpinButton Example", application=app) self.set_default_size(210, 70) self.set_border_width(5) # an adjustment (initial value, min value, max value, # step increment - press cursor keys or +/- buttons to see!, # page increment - not used here, # page size - not used here) ad = Gtk.Adjustment(0, 0, 100, 1, 0, 0) # a spin button for integers (digits=0) self.spin = Gtk.SpinButton(adjustment=ad, climb_rate=1, digits=0) # as wide as possible self.spin.set_hexpand(True) # we connect the signal "value-changed" emitted by the spinbutton with the callback # function spin_selected self.spin.connect("value-changed", self.spin_selected) # a label self.label = Gtk.Label() self.label.set_text("Choose a number") # a grid to attach the widgets grid = Gtk.Grid() grid.attach(self.spin, 0, 0, 1, 1) grid.attach(self.label, 0, 1, 2, 1) self.add(grid) # callback function: the signal of the spinbutton is used to change the # text of the label def spin_selected(self, event): self.label.set_text( "The number you selected is " + str(self.spin.get_value_as_int()) + ".") class MyApplication(Gtk.Application): def __init__(self): Gtk.Application.__init__(self) def do_activate(self): win = MyWindow(self) win.show_all() def do_startup(self): Gtk.Application.do_startup(self) app = MyApplication() exit_status = app.run(sys.argv) sys.exit(exit_status)
Χρήσιμες μέθοδοι για ένα γραφικό στοιχείο κουμπιού περιστροφής

Μια Gtk.Adjustment απαιτείται για δόμηση του Gtk.SpinButton. Αυτή η αναπαράσταση μιας τιμής με κάτω και άνω όριο, μαζί με βήμα και αυξήσεις σελίδας και μέγεθος σελίδας και δομείται ως Gtk.Adjustment(value, lower, upper, step_increment, page_increment, page_size) όπου τα πεδία είναι τύπου float· step_increment είναι η αύξηση/μείωση που παίρνεται χρησιμοποιώντας τα πλήκτρα δρομέα ή τα κουμπιά του κουμπιού περιστροφής. Σημειώστε ότι page_increment και page_size δεν χρησιμοποιούνται σε αυτήν την περίπτωση και δεν πρέπει να ορίζονται σε 0.

Στη γραμμή 23 το σήμα "value-changed" συνδέεται με τη συνάρτηση επανάκλησης spin_selected() χρησιμοποιώντας widget.connect(signal, callback function). Δείτε για μια πιο λεπτομερή εξήγηση.

Εάν θέλετε η τιμή του κουμπιούπεριστροφής να αναδιπλώνεται όταν υπερβαίνει το μέγιστο ή το ελάχιστο, ορίστε set_wrap(True). Το σήμα "wrapped" εκπέμπεται όταν συμβαίνει αυτό.

set_digits(digits) ορίζει την εμφανιζόμενη ακρίβεια από το κουμπί περιστροφής, μέχρι 20 ψηφία.

Για τη λήψη της τιμής του κουμπιού περιστροφής ως ακεραίου, χρησιμοποιήστε get_value_as_int().

Αναφορές API

Σε αυτό το παράδειγμα χρησιμοποιήσαμε τα παρακάτω:

GtkSpinButton

GtkAdjustment