scale

Имя в командной строке: -bigincrement
Имя базы данных: bigIncrement
Класс базы данных: BigIncrement: Некоторые взаимодействия со шкалой приводят к изменению ее значения на «большие» приращения; этот параметр определяет размер больших приращений. Если задано 0, большие приращения по умолчанию составляют 1/10 диапазона шкалы.
Имя в командной строке: -command
Имя базы данных: command
Класс базы данных: Command: Указывает префикс команд Tcl, которые будут вызываться всякий раз, когда значение шкалы изменяется с помощью команды виджета. Фактическая команда состоит из этого параметра, за которым следует пробел и действительное число, указывающее новое значение шкалы.
Имя в командной строке: -digits
Имя базы данных: digits
Класс базы данных: Digits: Целое число, определяющее количество значащих цифр, которые должны быть сохранены при преобразовании значения шкалы в строку. Если число меньше или равно нулю, шкала выбирает наименьшее значение, гарантирующее, что каждая возможная позиция ползунка отображается как другая строка.
Имя в командной строке: -from
Имя базы данных: from
Класс базы данных: From: Действительное значение, соответствующее левому или верхнему концу шкалы.
Имя в командной строке: -label
Имя базы данных: label
Класс базы данных: Label: Строка, отображаемая как метка для шкалы. Для вертикальных шкал метка отображается справа от верхнего конца шкалы. Для горизонтальных шкал метка отображается над левым концом шкалы. Если параметр задан как пустая строка, метка не отображается.
Имя в командной строке: -length
Имя базы данных: length
Класс базы данных: Length: Указывает желаемую длинную размерность шкалы в единицах экрана (то есть любой из форм, приемлемых для Tk_GetPixels). Для вертикальных шкал это высота шкалы; для горизонтальных шкал — ширина шкалы.
Имя в командной строке: -resolution
Имя базы данных: resolution
Класс базы данных: Resolution: Действительное значение, определяющее разрешение для шкалы. Если это значение больше нуля, значение шкалы всегда будет округляться до четного кратного этого значения, как и отметки и точки шкалы. Если значение меньше нуля, округление не происходит. По умолчанию 1 (то есть значение будет целым).
Имя в командной строке: -showvalue
Имя базы данных: showValue
Класс базы данных: ShowValue: Указывает булево значение, указывающее, отображается ли текущее значение шкалы.
Имя в командной строке: -sliderlength
Имя базы данных: sliderLength
Класс базы данных: SliderLength: Указывает размер ползунка, измеренный в единицах экрана вдоль длинной размерности ползунка. Значение может быть указано в любой из форм, приемлемых для Tk_GetPixels.
Имя в командной строке: -sliderrelief
Имя базы данных: sliderRelief
Класс базы данных: SliderRelief: Указывает рельеф, используемый при рисовании ползунка, такой как выпуклый или вогнутый.
Имя в командной строке: -state
Имя базы данных: state
Класс базы данных: State: Указывает одно из трех состояний шкалы: нормальный, активный или отключенный. Если шкала отключена, значение не может быть изменено, и шкала не активируется. Если шкала активна, ползунок отображается с цветом, указанным параметром -activebackground.
Имя в командной строке: -tickinterval
Имя базы данных: tickInterval
Класс базы данных: TickInterval: Должно быть действительным значением. Определяет интервал между числовыми отметками, отображаемыми под или слева от ползунка. Если 0, отметки не будут отображаться.
Имя в командной строке: -to
Имя базы данных: to
Класс базы данных: To: Указывает действительное значение, соответствующее правому или нижнему концу шкалы. Это значение может быть меньше или больше параметра -from.
Имя в командной строке: -variable
Имя базы данных: variable
Класс базы данных: Variable: Указывает имя глобальной переменной, которая должна быть связана со шкалой. Всякий раз, когда значение переменной изменяется, шкала обновляется, отражая это значение. Всякий раз, когда шкала изменяется интерактивно, переменная изменяется, отражая новое значение шкалы.
Имя в командной строке: -width
Имя базы данных: width
Класс базы данных: Width: Указывает желаемую узкую размерность желоба в единицах экрана (то есть любой из форм, приемлемых для Tk_GetPixels). Для вертикальных шкал это ширина желоба; для горизонтальных шкал — высота желоба.

Описание

Команда scale создает новое окно (заданное аргументом pathName) и преобразует его в виджет шкалы. Дополнительные параметры, описанные выше, могут быть заданы в командной строке или в базе параметров для настройки аспектов шкалы, таких как ее цвета, ориентация и рельеф. Команда scale возвращает свой аргумент pathName. В момент вызова этой команды не должно существовать окна с именем pathName This is an example of a scale widget.

Но pathName's parent должен существовать.

Масштаб — это виджет, который отображает прямоугольный желоб и небольшой ползунок. Желоб соответствует диапазону действительных значений (определяемых опциями -from, -to и -resolution), а положение ползунка выбирает определённое действительное значение. Положение ползунка (и, следовательно, значение шкалы) может быть скорректировано с помощью мыши или клавиатуры, как описано в разделе ПРИВЯЗКИ ниже. Всякий раз, когда значение шкалы изменяется, вызывается команда Tcl (с помощью опции -command), чтобы уведомить другие заинтересованные виджеты об изменении. Кроме того, значение шкалы может быть связано с переменной Tcl (с помощью опции -variable), так что изменения в одном отражаются в другом.

В виджете масштаба могут быть отображены три аннотации: метка, появляющаяся в правом верхнем углу виджета (в левом верхнем углу для горизонтальных шкал), число, отображаемое непосредственно слева от ползунка (непосредственно над ползунком для горизонтальных шкал) и набор числовых отметки, расположенных непосредственно слева от текущего значения (непосредственно под желобом для горизонтальных шкал). Каждая из этих трёх аннотаций может быть включена или выключена с помощью параметров конфигурации.

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

Команда scale создаёт новую команду Tcl с именем pathName. Эту команду можно использовать для вызова различных операций над виджетом. Она имеет следующий общий вид:

pathName option ?arg arg ...?

Option и args определяют точное поведение команды. Для виджетов шкалы возможны следующие команды:

pathName cget option: Возвращает текущее значение параметра конфигурации, заданного option. Option может принимать любые значения, которые принимаются командой scale.
pathName configure ?option? ?value option value ...?: Запрос или изменение параметров конфигурации виджета. Если option не указан, возвращает список, описывающий все доступные параметры для pathName (см. Tk_ConfigureInfo для получения информации о формате этого списка). Если option указан без value, то команда возвращает список, описывающий указанный параметр (этот список будет идентичен соответствующему подсписку возвращаемого значения, если option не указан). Если указана одна или несколько пар option-value, то команда изменяет заданные параметры виджета на заданные значения; в этом случае команда возвращает пустую строку. Option может принимать любые значения, которые принимаются командой scale.
pathName coords ?value?: Возвращает список, элементами которого являются координаты x и y точки по оси желоба, соответствующей value. Если value опущено, используется текущее значение шкалы.
pathName get ?x y?: Если x и y опущены, возвращает текущее значение шкалы. Если x и y указаны, они задают пиксельные координаты внутри виджета; команда возвращает значение шкалы, соответствующее заданным пикселям. Используется только одно из x или y: для горизонтальных шкал y игнорируется, а для вертикальных шкал игнорируется x.
pathName identify x y: Возвращает строку, указывающую, какая часть шкалы находится под координатами, заданными x и y. Значение slider означает, что точка находится над ползунком; trough1 означает, что точка находится над частью ползунка, расположенной выше или слева от ползунка; и trough2 означает, что точка находится над частью ползунка, расположенной ниже или справа от ползунка. Если точка не находится над одним из этих элементов, возвращается пустая строка.
pathName set value: Эта команда вызывается для изменения текущего значения шкалы, а следовательно, и положения, в котором отображается ползунок. Value задаёт новое значение шкалы. Команда не оказывает никакого эффекта, если шкала отключена.

Привязки

Tk автоматически создаёт привязки классов для шкал, которые обеспечивают им следующее поведение по умолчанию. Там, где поведение отличается для вертикальных и горизонтальных шкал, описывается горизонтальное поведение (в скобках).

Если нажата кнопка 1 в желобе, значение шкалы будет увеличено или уменьшено на значение параметра -resolution, так что ползунок будет перемещаться в направлении курсора. Если кнопка удерживается, действие повторяется автоматически.
Если нажата кнопка 1 над ползунком, ползунок можно перетащить мышкой.
Если нажата кнопка 1 в желобе при нажатой клавише Control, ползунок перемещается до крайнего значения в направлении курсора мыши.
Если нажата кнопка 2, значение шкалы устанавливается в позицию курсора мыши. Если при нажатой кнопке 2 перетащить мышь, значение шкалы меняется при перетаскивании.
Клавиши Up и Left перемещают ползунок вверх (влево) на значение параметра -resolution.
Клавиши Down и Right перемещают ползунок вниз (вправо) на значение параметра -resolution.
Клавиши Control-Up и Control-Left перемещают ползунок вверх (влево) на значение параметра -bigincrement.
Клавиши Control-Down и Control-Right перемещают ползунок вниз (вправо) на значение параметра -bigincrement.
Клавиша Home перемещает ползунок к начальному (левому) значению диапазона.
Клавиша End перемещает ползунок к конечному (правому) значению диапазона.

Если шкала отключена с помощью параметра -state, то ни одно из вышеперечисленных действий не имеет эффекта.

Поведение шкал можно изменить, определив новые настройки для отдельных виджетов или переопределив настройки класса.

См. также

ttk::scale

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