ttk_scrollbar

Виджеты ttk::scrollbar обычно связаны с ассоциированным окном, которое отображает документ какого-либо типа, например, редактируемый файл или чертёж. Скроллбар отображает ползунок в средней части, положение и размер которого предоставляют информацию о части документа, видимой в связанном окне. Пользователь может перетащить ползунок для управления видимой областью. В зависимости от темы могут присутствовать одна или две стрелочные кнопки; они используются для прокрутки видимой области на дискретные единицы.

Стандартные параметры

-class, неопределённое, неопределённое
-cursor, курсор, Курсор
-style, стиль, Стиль
-takefocus, takeFocus, TakeFocus

Параметры, специфичные для виджета

Название в командной строке: -command
Имя в базе данных: command
Класс в базе данных: Command: Префикс Tcl-скрипта для выполнения, изменяющий представление в виджете, связанном со скроллбаром. Дополнительные аргументы добавляются к значению этого параметра, как описано в разделе КОМАНДЫ ПРОКРУТКИ ниже, всякий раз, когда пользователь запрашивает изменение представления, манипулируя скроллбаром.
Этот параметр обычно состоит из двух элементов: имя прокручиваемого виджета и либо xview (для горизонтальных скроллбаров), либо yview (для вертикальных скроллбаров).
Название в командной строке: -orient
Имя в базе данных: orient
Класс в базе данных: Orient: Одно из значений horizontal или vertical. Определяет ориентацию скроллбара.

Команда виджета

pathName cget option: Возвращает текущее значение указанного параметра option; см. ttk::widget(n).
pathName configure ?option? ?value option value ...?: Изменение или запрос параметров виджета; см. ttk::widget(n).
pathName get: Возвращает настройки скроллбара в виде списка, элементы которого — аргументы последней команды виджета set.
pathName identify x y: Возвращает имя элемента в позиции x, y. См. ttk::widget(n).
pathName instate statespec ?script?: Проверка состояния виджета; см. ttk::widget(n).
pathName set first last: Эта команда обычно вызывается связанным виджетом скроллбара из обратного вызова -xscrollcommand или -yscrollcommand. Определяет видимый диапазон для отображения. first и last — действительные дроби от 0 до 1.
pathName state ?stateSpec?: Изменение или запрос состояния виджета; см. ttk::widget(n).

Внутренние команды

Следующие команды виджета используются внутренними связываниями класса виджета TScrollbar.

pathName delta deltaX deltaY: Возвращает действительное число, указывающее дробное изменение настроек скроллбара, соответствующее заданному изменению положения ползунка. Например, если скроллбар горизонтальный, результат указывает, на сколько нужно изменить настройку скроллбара, чтобы переместить ползунок на deltaX пикселей вправо (deltaY в этом случае игнорируется). Если скроллбар вертикальный, результат указывает, на сколько нужно изменить настройку скроллбара, чтобы переместить ползунок на deltaY пикселей вниз. Аргументы и результат могут быть нулевыми или отрицательными.
pathName fraction x y: Возвращает действительное число от 0 до 1, указывающее, где находится точка, заданная x и y, в области канала скроллбара, где 0.0 соответствует верхней или левой части канала, а 1.0 — нижней или правой. X и y — координаты пикселей относительно виджета скроллбара. Если x и y относятся к точке за пределами канала, используется ближайшая точка в канале.

Команды прокрутки

Когда пользователь взаимодействует со скроллбаром, например, перетаскивает ползунок, скроллбар уведомляет связанный виджет о необходимости изменения его представления. Уведомление происходит путём выполнения Tcl-команды, сгенерированной из параметра -command скроллбара. Команда может иметь любой из следующих форматов. В каждом случае prefix — содержимое параметра -command, которое обычно имеет вид .t yview

prefix moveto fraction: Fraction — действительное число от 0 до 1. Виджет должен настроить своё представление так, чтобы точка, заданная fraction, находилась в начале виджета. Если fraction равно 0, это начало документа. 1.0 относится к концу документа, 0.333 — к точке, находящейся на одной трети пути по документу, и так далее.
prefix scroll number units: Виджет должен настроить своё представление, сдвинув его на number единиц. Единицы определяются тем, что имеет смысл для виджета, например, символы или строки в текстовом виджете. Number может быть 1, что означает сдвиг представления на одну единицу вверх или влево, или -1, что означает сдвиг представления на одну единицу вниз или вправо.
prefix scroll number pages: Виджет должен настроить своё представление, сдвинув его на number страниц. Виджету предоставляется право определять смысл страницы; обычно это немного меньше, чем умещается в окне, так что есть небольшое перекрытие между старым и новым представлением. Number может быть 1, что означает отображение следующей страницы, или -1, что означает отображение предыдущей страницы.

Состояния виджета

Скроллбар автоматически устанавливает флаг disabled, когда весь диапазон виден (диапазон от 0.0 до 1.0), и сбрасывает его в противном случае. Также он устанавливает флаги active и pressed для отдельных элементов на основе положения и состояния указателя мыши.

Пример

set f [frame .f]
ttk::scrollbar $f.hsb -orient horizontal -command [list $f.t xview]
ttk::scrollbar $f.vsb -orient vertical -command [list $f.t yview]
text $f.t -xscrollcommand [list $f.hsb set] -yscrollcommand [list $f.vsb set]
grid $f.t -row 0 -column 0 -sticky nsew
grid $f.vsb -row 0 -column 1 -sticky nsew
grid $f.hsb -row 1 -column 0 -sticky nsew
grid columnconfigure $f 0 -weight 1
grid rowconfigure $f 0 -weight 1

Смотрите также

ttk::widget, scrollbar

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TkCmd/ttk_scrollbar.htm