ttk_notebook

ИМЯ

ttk::notebook — Виджет контейнера с несколькими вкладками

СИНТАКСИС

ОПИСАНИЕ

СТАНДАРТНЫЕ ПАРАМЕТРЫ

-class, неопределённый, неопределённый

-cursor, курсор, Курсор

-style, стиль, Стиль

-takefocus, takeFocus, TakeFocus

Имя

Синтаксис

Описание

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

-class, неопределённый, неопределённый

-cursor, курсор, Курсор

-style, стиль, Стиль

-takefocus, takeFocus, TakeFocus

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

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

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

Класс в базе данных: Высота

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

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

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

Класс в базе данных: Отступ

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

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

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

Класс в базе данных: Ширина

Если указано и больше нуля, задаёт желаемую ширину области панели (без учёта внутренних отступов). В противном случае используется максимальная ширина всех панелей.

Параметры вкладок

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

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

Класс в базе данных: Состояние

Может принимать значения normal, disabled или hidden. Если disabled, то вкладка не выбирается. Если hidden, то вкладка не отображается.

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

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

Класс в базе данных: Прилипание

Задаёт способ позиционирования дочернего окна внутри области панели. Значение — строка, содержащая ноль или более символов n, s, e, или w. Каждый символ соответствует стороне (север, юг, восток или запад), к которой будет «прилипать» дочернее окно, как и в менеджере геометрии grid.

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

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

Класс в базе данных: Отступ

Задаёт количество дополнительного пространства между виджетом notebook и этой панелью. Синтаксис такой же, как и для параметра -padding виджета.

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

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

Класс в базе данных: Текст

Задаёт строку, отображаемую на вкладке.

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

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

Класс в базе данных: Изображение

Задаёт изображение для отображения на вкладке. Подробнее см. ttk_widget(n).

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

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

Класс в базе данных: Комбинация

Задаёт способ отображения изображения относительно текста, если указаны -text и -image. Допустимые значения см. в label(n).

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

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

Класс в базе данных: Подчеркивание

Задаёт целочисленный индекс (от 0) символа для подчеркивания в строке текста. Подчеркнутый символ используется для активации мнемоники, если вызвана ttk::notebook::enableTraversal.

Идентификаторы вкладок

• Целое число от нуля до количества вкладок;
• Имя дочернего окна;
• Позиционное задание вида «@x,y», определяющее вкладку
• Литеральная строка «current», определяющая текущую вкладку; или:
• Литеральная строка «end», возвращающая количество вкладок (действительно только для «pathname index»).

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

pathname add window ?options...?

Добавляет новую вкладку в блокнот. Смотрите ВАРИАНТЫ ВКЛАДОК для списка доступных options. Если window в настоящее время управляется блокнотом, но скрыт, он восстанавливается до своего предыдущего положения.

pathname configure ?options?

См. ttk::widget(n).

pathname cget option

См. ttk::widget(n).

pathname forget tabid

Удаляет вкладку, указанную tabid, отключает и прекращает управление связанным окном.

pathname hide tabid

Скрывает вкладку, указанную tabid. Вкладка не будет отображаться, но связанное окно остаётся управляемым блокнотом и его конфигурация запоминается. Скрытые вкладки могут быть восстановлены командой add.

pathname identify component x y

Возвращает имя элемента под точкой, заданной x и y, или пустую строку, если в этой области нет элемента. Поддерживаются следующие подкоманды:

pathname identify element x y

Возвращает имя элемента в указанном месте.

pathname identify tab x y

Возвращает индекс вкладки в указанном месте.

pathname index tabid

Возвращает числовой индекс вкладки, указанной tabid, или общее количество вкладок, если tabid — строка «end».

pathname insert pos subwindow options...

Вставляет вкладку в указанную позицию. pos — это либо строка end, целочисленный индекс, либо имя управляемого подокна. Если subwindow уже управляется блокнотом, перемещает его в указанную позицию. Смотрите ВАРИАНТЫ ВКЛАДОК для списка доступных опций.

pathname instate statespec ?script...?

См. ttk::widget(n).

pathname select ?tabid?

Выбирает указанную вкладку. Соответствующее окно-дочернее будет отображено, а ранее выбранное окно (если оно отличается) — скрыто. Если tabid опущено, возвращает имя виджета текущей выбранной вкладки.

pathname state ?statespec?

См. ttk::widget(n).

pathname tab tabid ?-option ?value ...

Запрос или изменение опций конкретной вкладки. Если -option не указан, возвращает словарь значений опций вкладки. Если один -option указан, возвращает значение этого option. В противном случае устанавливает -option в соответствующие value. См. ВАРИАНТЫ ВКЛАДОК для доступных опций.

pathname tabs

Возвращает список окон, управляемых блокнотом.

Проход по клавиатуре

ttk::notebook::enableTraversal $nb

Это расширит привязки для главного окна, содержащего блокнот следующим образом:

• Ctrl-Tab выбирает вкладку, следующую за текущей.
• Ctrl-Shift-Tab выбирает вкладку, предшествующую текущей.
• Alt-K, где K — мнемонический символ любой вкладки, выберет эту вкладку.

Несколько блокнотов в одном главном окне могут быть включены для прохода, включая вложенные блокноты. Однако проход по блокнотам работает правильно только если все вкладки являются непосредственными дочерними элементами блокнота.

Виртуальные события

Пример

pack [ttk::notebook .nb]
	.nb add [frame .nb.f1] -text "First tab"
	.nb add [frame .nb.f2] -text "Second tab"
	.nb select .nb.f2
ttk::notebook::enableTraversal .nb

См. также