Кнопка-счётчик (gtk.SpinButton)

Виджет SpinButton используется для того чтобы выбрать значение из определённого диапазона чисел. Он содержит поле ввода текста и кнопки вверх и вниз. Выбор одной из кнопок прокручивает значение вверх или вниз. Поэтому этот составной виджет можно называть “кнопка-счётчик”. Поле ввода также может быть отредактировано напрямую, вводом нужного значения.

Виджет SpinButton позволяет значению иметь 0 или больше десятичных позиций, и увеличиваться/уменьшаться с определённым настроенным шагом. Зажатие одной из кнопок может приводить к ускорению изменений значения, в зависимости от времени зажатия.

Виджет SpinButton использует регулятор (см. Глава 7, Регуляторы), для хранения информации о диапазоне значений который может принимать. Это делает виджет SpinButton мощным.

Напоминаем, что виджет Adjustment создаётся с помощью следующей функции:

  adjustment = gtk.Adjustment(value=0, lower=0, upper=0, step_incr=0, page_incr=0, page_size=0)

Эти параметры регулятора используются виджетом SpinButton следующим путём:

value Начальное значение SpinButton
lower Минимальное значение
upper Максимальное значение
step_increment Значение увеличения/уменьшения при клике левой кнопкой.
page_increment Значение увеличения/уменьшения при клике правой кнопкой.
page_size Не используется

Дополнительно, третья кнопка мыши может быть использована для прыжка напрямую к минимальному или максимальному значению. Давайте посмотрим как создать SpinButton::

  spin_button = gtk.SpinButton(adjustment=None, climb_rate=0.0, digits=0)

Аргумент climb_rate принимает значение между 0.0 и 1.0, и показывает величину ускорения. Аргумент digits указывает количество отображаемых десятичных позиций.

SpinButton может быть перенастроена с помощью следующего метода:

  spin_button.configure(adjustment, climb_rate, digits)

Аргумент spin_button указывает какой из виджетов SpinButton должен быть перенастроен. Другие аргументы объяснены выше.

Регулятор может быть указан или получен с помощью следующих методов:

  spin_button.set_adjustment(adjustment)

  adjustment = spin_button.get_adjustment()

Количество десятичных позиций может быть изменено с помощью:

  spin_button.set_digits(digits)

Значение отображаемое в SpinButton может быть изменено с помощью метода:

  spin_button.set_value(value)

Текущее значение SpinButton может быть получено как дробное или целое значение с помощью следующих методов:

  float_value = spin_button.get_value()

  int_value = spin_button.get_value_as_int()

Если вы хотите изменить значение SpinButton относительно текущего значения, используйте следующий метод:

  spin_button.spin(direction, increment)

Параметр direction может принимать одно из следующих значений:

  SPIN_STEP_FORWARD
  SPIN_STEP_BACKWARD
  SPIN_PAGE_FORWARD
  SPIN_PAGE_BACKWARD
  SPIN_HOME
  SPIN_END
  SPIN_USER_DEFINED

Этот метод содержит совсем немного функционала, который мы постараемся ясно объяснить. Большинство этих настроек использует регулятор, связанный со SpinButton.

SPIN_STEP_FORWARD и SPIN_STEP_BACKWARD изменяют значение SpinButton в размере указанном в increment, за исключением того что если increment равен 0, то в таком случае значение изменяется на step_increment в регляторе.

SPIN_PAGE_FORWARD и SPIN_PAGE_BACKWARD просто меняют значение SpinButton на increment.

SPIN_HOME устанавливает минимальное значение из диапазона регулятора.

SPIN_END устанавливает максимально значение из диапазона регулятора.

SPIN_USER_DEFINED просто меняет значение SpinButton на указанную величину.

Мы уходим от методов для настройки и получения значения или диапазона, и переходим к методам, отвечающим за внешний вид и поведение виджета SpinButton.

Первый из этих методов используется для ограничения поля ввода, которое может содержать только числа. Это защищает от ввода отличных от цифр символов в поле ввода SpinButton:

  spin_button.set_numeric(numeric)

numeric  содержащий TRUE контролирует ввод в поле, и позволяет любой ввод при значении FALSE.

Вы можете выбрать будет ли SpinButton перескакивать между максимальным и минимальным значением, достигая предела, с помощью следующего метода:

  spin_button.set_wrap(wrap)

SpinButton будет перескакивать если wrap равен TRUE.

Вы можете приказать SpinButton округлять значения до ближайшего step_increment, указанного в регуляторе. Это происходит, если передать аргументу snap_to_ticks в следующем методе TRUE:

  spin_button.set_snap_to_ticks(snap_to_ticks)

Политика обновления SpinButton может быть изменена следующим методом:

  spin_button.set_update_policy(policy)

Возможные значения:

  UPDATE_ALWAYS

  UPDATE_IF_VALID

Эти значения определяют поведение SpinButton при просмотре введённого текста и синхронизации его значения с регулятором.

В случае UPDATE_IF_VALID значение изменяется только если введённое значение является числом входящим в диапазон значений регулятора.  Изменит текст на текущее значение.

В случае UPDATE_ALWAYS мы игнорируем ошибки конвертации текста в числовое значение.

Наконец, вы можете явно запросить обновление для SpinButton.

  spin_button.update()

Пример spinbutton.py показывает использование виджетов SpinButton, включая настройку характеристик. Рисунок  9.11, “Пример виджетов Spin Button” показывает результат запуска программы:

Рисунок 9.11. Пример виджетов Spin Button

Spin Button Example

Исходный код spinbutton.py:

#!/usr/bin/env python
# -*- coding:utf-8 -*-
# example spinbutton.py

import pygtk
pygtk.require('2.0')
import gtk

class SpinButtonExample:
    def toggle_snap(self, widget, spin):
        spin.set_snap_to_ticks(widget.get_active())

    def toggle_numeric(self, widget, spin):
        spin.set_numeric(widget.get_active())

    def change_digits(self, widget, spin, spin1):
        spin1.set_digits(spin.get_value_as_int())

    def get_value(self, widget, data, spin, spin2, label):
        if data == 1:
            buf = "%d" % spin.get_value_as_int()
        else:
            buf = "%0.*f" % (spin2.get_value_as_int(),
                             spin.get_value())
        label.set_text(buf)

    def __init__(self):
        window = gtk.Window(gtk.WINDOW_TOPLEVEL)
        window.connect("destroy", lambda w: gtk.main_quit())
        window.set_title("Кнопки-счётчики")

        main_vbox = gtk.VBox(False, 5)
        main_vbox.set_border_width(10)
        window.add(main_vbox)

        frame = gtk.Frame("Не ускоряемые")
        main_vbox.pack_start(frame, True, True, 0)
  
        vbox = gtk.VBox(False, 0)
        vbox.set_border_width(5)
        frame.add(vbox)

        # День, месяц, год.
        hbox = gtk.HBox(False, 0)
        vbox.pack_start(hbox, True, True, 5)
  
        vbox2 = gtk.VBox(False, 0)
        hbox.pack_start(vbox2, True, True, 5)

        label = gtk.Label("День :")
        label.set_alignment(0, 0.5)
        vbox2.pack_start(label, False, True, 0)
  
        adj = gtk.Adjustment(1.0, 1.0, 31.0, 1.0, 5.0, 0.0)
        spinner = gtk.SpinButton(adj, 0, 0)
        spinner.set_wrap(True)
        vbox2.pack_start(spinner, False, True, 0)
  
        vbox2 = gtk.VBox(False, 0)
        hbox.pack_start(vbox2, True, True, 5)
  
        label = gtk.Label("Месяц :")
        label.set_alignment(0, 0.5)
        vbox2.pack_start(label, False, True, 0)

        adj = gtk.Adjustment(1.0, 1.0, 12.0, 1.0, 5.0, 0.0)
        spinner = gtk.SpinButton(adj, 0, 0)
        spinner.set_wrap(True)
        vbox2.pack_start(spinner, False, True, 0)
  
        vbox2 = gtk.VBox(False, 0)
        hbox.pack_start(vbox2, True, True, 5)
  
        label = gtk.Label("Год :")
        label.set_alignment(0, 0.5)
        vbox2.pack_start(label, False, True, 0)
  
        adj = gtk.Adjustment(2011.0, 0.0, 2100.0, 1.0, 100.0, 0.0)
        spinner = gtk.SpinButton(adj, 0, 0)
        spinner.set_wrap(False)
        spinner.set_size_request(55, -1)
        vbox2.pack_start(spinner, False, True, 0)
  
        frame = gtk.Frame("Ускоряемые")
        main_vbox.pack_start(frame, True, True, 0)
  
        vbox = gtk.VBox(False, 0)
        vbox.set_border_width(5)
        frame.add(vbox)
  
        hbox = gtk.HBox(False, 0)
        vbox.pack_start(hbox, False, True, 5)
  
        vbox2 = gtk.VBox(False, 0)
        hbox.pack_start(vbox2, True, True, 5)
  
        label = gtk.Label("Значение :")
        label.set_alignment(0, 0.5)
        vbox2.pack_start(label, False, True, 0)
  
        adj = gtk.Adjustment(0.0, -10000.0, 10000.0, 0.5, 100.0, 0.0)
        spinner1 = gtk.SpinButton(adj, 1.0, 2)
        spinner1.set_wrap(True)
        spinner1.set_size_request(100, -1)
        vbox2.pack_start(spinner1, False, True, 0)
  
        vbox2 = gtk.VBox(False, 0)
        hbox.pack_start(vbox2, True, True, 5)
  
        label = gtk.Label("Разрядов :")
        label.set_alignment(0, 0.5)
        vbox2.pack_start(label, False, True, 0)
  
        adj = gtk.Adjustment(2, 1, 5, 1, 1, 0)
        spinner2 = gtk.SpinButton(adj, 0.0, 0)
        spinner2.set_wrap(True)
        adj.connect("value_changed", self.change_digits, spinner2, spinner1)
        vbox2.pack_start(spinner2, False, True, 0)
  
        hbox = gtk.HBox(False, 0)
        vbox.pack_start(hbox, False, True, 5)

        button = gtk.CheckButton("Округлять до 0.5")
        button.connect("clicked", self.toggle_snap, spinner1)
        vbox.pack_start(button, True, True, 0)
        button.set_active(True)
  
        button = gtk.CheckButton("Только числовой ввод")
        button.connect("clicked", self.toggle_numeric, spinner1)
        vbox.pack_start(button, True, True, 0)
        button.set_active(True)
  
        val_label = gtk.Label("")
  
        hbox = gtk.HBox(False, 0)
        vbox.pack_start(hbox, False, True, 5)
        button = gtk.Button("Значение как Int")
        button.connect("clicked", self.get_value, 1, spinner1, spinner2,
                       val_label)
        hbox.pack_start(button, True, True, 5)
  
        button = gtk.Button("Значение как Float")
        button.connect("clicked", self.get_value, 2, spinner1, spinner2,
                       val_label)
        hbox.pack_start(button, True, True, 5)
  
        vbox.pack_start(val_label, True, True, 0)
        val_label.set_text("0")
  
        hbox = gtk.HBox(False, 0)
        main_vbox.pack_start(hbox, False, True, 0)
  
        button = gtk.Button(gtk.STOCK_CLOSE, gtk.STOCK_CLOSE)
        button.connect("clicked", lambda w: gtk.main_quit())
        hbox.pack_start(button, True, True, 5)
        window.show_all()

def main():
    gtk.main()
    return 0

if __name__ == "__main__":
    SpinButtonExample()
    main()
Предыдущая страница На уровень выше  Следующая страница
9.9. Поле ввода текста (gtk.Entry) К оглавлению  9.11. Комбинированный список (gtk.Combo)

Оставить комментарий

Ваш email не будет опубликован. Обязательные поля отмечены *

Вы можете использовать это HTMLтеги и атрибуты: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>