# Scale (Python)

Marta Maria Casetti
mmcasetti@gmail.com 2012
Widget stupnice pro výběr hodnoty z nějakého rozsahu

# Scale

Jezděte po stupnici!

# 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="Scale Example", application=app) self.set_default_size(400, 300) self.set_border_width(5)

# Dvě přizpůsobení (počáteční hodnota, min. hodnota, max. hodnota, # přírůstek kroku - viz zmáčknutí kláves, # přírůstek stránky - viz kliknutí mimo táhlo, # velikost stránky - zde nepoužito) ad1 = Gtk.Adjustment(0, 0, 100, 5, 10, 0) ad2 = Gtk.Adjustment(50, 0, 100, 5, 10, 0)

# Vodorovná stupnice self.h_scale = Gtk.Scale( orientation=Gtk.Orientation.HORIZONTAL, adjustment=ad1) # S celými čísly (bez desetinných míst) self.h_scale.set_digits(0) # Může se vodorovně roztáhnout, když je v mřížce místo (viz dále) self.h_scale.set_hexpand(True) # Je zarovnaná k horní části místa vyhrazeného v mřížce (viz dále) self.h_scale.set_valign(Gtk.Align.START)

# Napojí signál "value-changed" vyslaný stupnicí na funkci # zpětného volání scale_moved self.h_scale.connect("value-changed", self.scale_moved)

# Svislá stupnice self.v_scale = Gtk.Scale( orientation=Gtk.Orientation.VERTICAL, adjustment=ad2) # Může se svisle roztáhnout, když je v mřížce místo (viz dále) self.v_scale.set_vexpand(True)

# Napojí signál "value-changed" vyslaný stupnicí na funkci # zpětného volání scale_moved self.v_scale.connect("value-changed", self.scale_moved)

# Popisek self.label = Gtk.Label() self.label.set_text("Move the scale handles...")

# Mřížka pro připojení widgetů grid = Gtk.Grid() grid.set_column_spacing(10) grid.set_column_homogeneous(True) grid.attach(self.h_scale, 0, 0, 1, 1) grid.attach_next_to( self.v_scale, self.h_scale, Gtk.PositionType.RIGHT, 1, 1) grid.attach(self.label, 0, 1, 2, 1)

self.add(grid)

# Který koliv signál od stupnice říká popisku, že má změnit text def scale_moved(self, event): self.label.set_text("Horizontal scale is " + str(int(self.h_scale.get_value())) + "; vertical scale is " + str(self.v_scale.get_value()) + ".")

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 Scale

`Gtk.Adjustment` je zapotřebí k vytvoření `Gtk.Scale`. 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, `přírůstek_stránky` to stejné, ale při kliknutí na stupnici. Poznamenejme, že `velikost_stránky` zde nevyužíváme a měla by být nastavena na `0`.

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

`get_value()` získá aktuální hodnotu ze stupnice. `set_value(hodnota)` ji nastaví (pokud je `hodnota` typu `float` mimo rozsah minima a maxima, bude stažena tak, aby do něj zapadala). Toto jsou metody třídy Gtk.Range.

Použití `set_draw_value(False)` zabrání zobrazování aktuální hodnoty v podobě řetězce vedle stupnice.

Když chcete zvýraznit část stupnice mezi počátkem a aktuální hodnotou:

self.h_scale.set_restrict_to_fill_level(False) self.h_scale.set_fill_level(self.h_scale.get_value()) self.h_scale.set_show_fill_level(True)

ve funkci zpětného volání pro signál `"value-changed"`, takže se znovu vyplní pokaždé, když se změní hodnota. Jedná se o metodu třídy Gtk.Range.

`add_mark(hodnota, pozice, značka)` přidá značku s `hodnotou` (`float` nebo `int`, pokud je stupnice s přesností na celá čísla) v místě `pozice` (`Gtk.PositionType.LEFT`, `Gtk.PositionType.RIGHT`, `Gtk.PositionType.TOP`, `Gtk.PositionType.BOTTOM`) s textem `Null` nebo `značka` ve značkovacím jazyce Pango. Ke smazání značek použijte `clear_marks()`.

`set_digits(číslic)` nastaví přesnost stupnice na zadaný počet `číslic`.

# Odkazy k API

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

GtkScale

GtkAdjustment

Standardní výčtové konstanty