ttk_widget

Имя в командной строке: -class
Имя в базе данных: undefined
Класс в базе данных: undefined: Определяет класс окна. Класс используется при запросе параметров окна в базе данных, для определения значений bindtags окна, а также для выбора шаблона и стиля виджета. Это параметр только для чтения: он может быть задан только при создании окна и не может быть изменён с помощью команды configure виджета.
Имя в командной строке: -cursor
Имя в базе данных: cursor
Класс в базе данных: Cursor: Устанавливает курсор мыши для виджета. См. Tk_GetCursor и cursors(n) в справочнике по Tk для допустимых значений. Если установлено пустой строкой (по умолчанию), курсор наследуется от родительского виджета.
Имя в командной строке: -takefocus
Имя в базе данных: takeFocus
Класс в базе данных: TakeFocus: Определяет, принимает ли окно фокус при перемещении по клавиатуре. Может принимать значения 0, 1, префикс команды (к которому добавляется путь к виджету, и который должен возвращать 0 или 1), или пустую строку. См. options(n) в справочнике по Tk для полного описания.
Имя в командной строке: -style
Имя в базе данных: style
Класс в базе данных: Style: Может быть использован для указания пользовательского стиля виджета.

Параметры прокручиваемых виджетов

Следующие параметры поддерживаются виджетами, которые могут управляться полосой прокрутки. См. scrollbar(n) для получения дополнительной информации

Имя в командной строке: -xscrollcommand

Имя в базе данных: xScrollCommand

Класс в базе данных: ScrollCommand

Префикс команды, используемый для взаимодействия с горизонтальными полосами прокрутки. При изменении области просмотра в окне виджета, виджет создаёт Tcl-команду, объединив команду прокрутки и две цифры. Каждая цифра — дробь от 0 до 1, указывающая на позицию в документе; 0 — начало, 1 — конец. Первая дробь обозначает первую видимую в окне часть документа, вторая — часть документа, следующую за последней видимой частью.

Обычно параметр -xscrollcommand состоит из имени пути виджета scrollbar, за которым следует "set", например ".x.scrollbar set". Это обновит полосу прокрутки при каждом изменении области просмотра в окне.

Если этот параметр установлен в пустую строку (по умолчанию), то никакой команды не выполняется.

Имя в командной строке: -yscrollcommand

Имя в базе данных: yScrollCommand

Класс в базе данных: ScrollCommand

Префикс команды, используемый для взаимодействия с вертикальными полосами прокрутки. См. описание -xscrollcommand выше для получения подробностей.

Параметры метки

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

Имя в командной строке: -text

Имя в базе данных: text

Класс в базе данных: Text

Устанавливает строку текста, отображаемую внутри виджета (если не переопределено параметром -textvariable).

Имя в командной строке: -textvariable

Имя в базе данных: textVariable

Класс в базе данных: Variable

Указывает имя глобальной переменной, значение которой будет использоваться вместо параметра -text.

Имя в командной строке: -underline

Имя в базе данных: underline

Класс в базе данных: Underline

Если задано, указывает целочисленный индекс (с нуля) символа для подчеркивания в строке текста. Подчеркнутый символ используется для активации мнемоники.

Имя в командной строке: -image

Имя в базе данных: image

Класс в базе данных: Image

Указывает изображение для отображения. Это список из 1 или более элементов. Первый элемент — имя изображения по умолчанию. Остальная часть списка — последовательность пар statespec / value, как в style map, указывающая различные изображения, используемые, когда виджет находится в определённом состоянии или комбинации состояний. Все изображения в списке должны иметь одинаковый размер.

Имя в командной строке: -compound

Имя в базе данных: compound

Класс в базе данных: Compound

Указывает способ отображения изображения относительно текста в случае, если присутствуют как -text, так и -image. Допустимые значения:

текст: Отобразить только текст.
изображение: Отобразить только изображение.
центр: Отобразить текст, центрированный поверх изображения.
верх
низ
слева
справа: Отобразить изображение над, под, слева или справа от текста соответственно.
нет: По умолчанию; отобразить изображение, если оно есть, в противном случае — текст.

Имя в командной строке: -width

Имя в базе данных: width

Класс в базе данных: Width

Если больше нуля, указывает, сколько места, в ширине символов, выделить для метки текста. Если меньше нуля, указывает минимальную ширину. Если ноль или не указано, используется естественная ширина метки текста.

Параметры совместимости

Имя в командной строке: -state
Имя в базе данных: state
Класс в базе данных: State: Может быть установлен в normal или disabled для управления битом состояния disabled. Это параметр только для записи: его установка изменяет состояние виджета, но команда виджета state не влияет на параметр -state.

Команды

имя_пути cget параметр

Возвращает текущее значение конфигурационного параметра, заданного параметром.

имя_пути configure ?параметр? ?значение_параметра значение ...?

Запрос или изменение конфигурационных параметров виджета. Если указаны одна или несколько пар параметр-значение, то команда изменяет заданный(ые) параметр(ы) виджета на указанное(ые) значение(я); в этом случае команда возвращает пустую строку. Если параметр указан без значения, то команда возвращает список, описывающий указанный параметр: элементами списка являются имя параметра, имя базы данных, класс базы данных, значение по умолчанию и текущее значение. Если параметр не указан, возвращает список, описывающий все доступные параметры для имя_пути.

имя_пути identify element x y

Возвращает имя элемента под точкой, заданной x и y, или пустую строку, если точка не лежит внутри элемента. x и y — это координаты пикселей относительно виджета. Некоторые виджеты принимают другие подкоманды identify.

имя_пути instate спецификация_состояния ?скрипт?

Проверка состояния виджета. Если скрипт не указан, возвращает 1, если состояние виджета соответствует спецификации_состояния, и 0 в противном случае. Если скрипт указан, эквивалентно

if {[pathName instate stateSpec]} script

имя_пути state ?спецификация_состояния?

Изменение или запрос состояния виджета. Если спецификация_состояния присутствует, устанавливает состояние виджета: для каждого флага в спецификации_состояния устанавливает соответствующий флаг или очищает его, если он префиксен восклицательным знаком (!).

Возвращает новую спецификацию состояния, указывающую, какие флаги были изменены:

set changes [pathName state spec]
pathName state $changes

восстановит имя_пути в исходное состояние. Если спецификация_состояния не указана, возвращает список текущих флагов состояния.

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

Состояние виджета — это битовая карта независимых флагов состояния. Флаги состояния виджетов включают:

active: Курсор мыши находится над виджетом, и нажатие кнопки мыши вызовет какое-то действие. (также «prelight» (Gnome), «hot» (Windows), «hover»).
disabled: Виджет отключен под управлением программы (также «недоступный», «неактивный»).
focus: Виджет имеет фокус клавиатуры.
pressed: Виджет нажат (также «armed» в Motif).
selected: «Включен», «истина» или «текущий» для элементов, таких как флажки и радиокнопки.
background: Окна и Mac имеют понятие «активного» или фонового окна. Состояние background устанавливается для виджетов в фоновом окне и сбрасывается для тех, которые находятся в фоновом окне.
readonly: Виджет не должен допускать изменения пользователем.
alternate: Специфичный для виджета альтернативный формат отображения. Например, используется для флажков и радиокнопок в состоянии «tristate» или «mixed», а также для кнопок с -default active.
invalid: Значение виджета некорректно. (Возможные использования: значение виджета шкалы за пределами допустимого диапазона, значение виджета поля ввода не прошло проверку.)
hover: Курсор мыши находится внутри виджета. Это аналогично состоянию active; используется в некоторых темах для виджетов, которые обеспечивают отличную визуальную обратную связь для активного виджета в дополнение к активному элементу внутри виджета.

Спецификация состояния или спецификация_состояния — это список имен состояний, необязательно префиксённых восклицательным знаком (!) для указания выключения бита.

Примеры

set b [ttk::button .b]

# Disable the widget:
$b state disabled

# Invoke the widget only if it is currently pressed and enabled:
$b instate {pressed !disabled} { .b invoke }

# Reenable widget:
$b state !disabled

См. также

ttk::intro, ttk::style

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