# SpinButton (Python)

Marta Maria Casetti
mmcasetti@gmail.com 2012
Získává celé nebo desetinné číslo od uživatele.

# SpinButton

Zvolte číslo tak, že jej napíšete nebo naklikáte tlačítky +/-!

# Kód použitý k vygenerování tohoto příkladu

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)

# Přizpůsobení (počáteční hodnota, min. hodnota, max. hodnota, # přírůstek kroku - viz zmáčknutí kurzorových kláves nebo +/-, # přírůstek stránky - zde nepoužito, # velikost stránky - zde nepoužito) ad = Gtk.Adjustment(0, 0, 100, 1, 0, 0)

# Číselník pro celá čísla (digits=0) self.spin = Gtk.SpinButton(adjustment=ad, climb_rate=1, digits=0) # Tak široký, jak je možné self.spin.set_hexpand(True)

# Napojí signál "value-changed" vyslaný číselníkem na funkci # zpětného volání spin_selected self.spin.connect("value-changed", self.spin_selected)

# Popisek self.label = Gtk.Label() self.label.set_text("Choose a number")

# Mřížka pro připojení widgetů grid = Gtk.Grid() grid.attach(self.spin, 0, 0, 1, 1) grid.attach(self.label, 0, 1, 2, 1)

self.add(grid)

# Funkce zpětného volání: signál widgetu SpinButton je použit ke změně # textu popisku 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)

# Užitečné metody pro widget SpinButton

`Gtk.Adjustment` je zapotřebí k vytvoření `Gtk.SpinButton`. Představuje hodnoty se spodní a horní hranicí, spolu s přírůstkem kroku a stránky a velikostí stránky, a vytváří se pomocí `Gtk.Adjustment(hodnota, spodní, horní, přírůstek_kroku, přírůstek_stránky, velikost_stránky)`, kde jednotlivé parametry jsou typu `float`. `přírůstek_kroku` určuje o kolik se má zvýšit/snížit hodnota při použití kurzorových kláves. Poznamenejme, že `přírůstek_stránky` a `velikost_stránky` zde nevyužíváme a měly by být nastaveny na `0`.

Na řádku 23 je signál `"value-changed"` napojen na funkci zpětného volání `spin_selected()` pomocí `widget.connect(signál, funkce zpětného volání)`. Podrobnější vysvětlení viz .

Pokud chcete, aby hodnota v číselníku cyklicky přecházela přes meze, když dosáhne maxima nebo minima, nastavte `set_wrap(True)`. Když se tak stane, je vyslán signál `"wrapped"`.

`set_digits(digits)` nastavuje přesnost zobrazení číselníkem, až na 20 číslic.

Pro získání hodnoty z číselníku v podobě celého čísla použijte `get_value_as_int()`.

# Odkazy k API

V této ukázce se používá následující:

GtkSpinButton

GtkAdjustment