toplevel

ИМЯ

toplevel — Создание и управление виджетами основных и всплывающих окон 'toplevel'

СИНТАКСИС

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

-borderwidth или -bd, borderWidth, BorderWidth

-cursor, cursor, Cursor

-highlightbackground, highlightBackground, HighlightBackground

-highlightcolor, highlightColor, HighlightColor

-highlightthickness, highlightThickness, HighlightThickness

-padx, padX, Отступ

-pady, padY, Отступ

-relief, relief, Рельеф

-takefocus, takeFocus, Получение фокуса

Имя

Синопсис

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

-borderwidth или -bd, borderWidth, BorderWidth

-cursor, cursor, Cursor

-highlightbackground, highlightBackground, HighlightBackground

-highlightcolor, highlightColor, HighlightColor

-highlightthickness, highlightThickness, HighlightThickness

-padx, padX, Отступ

-pady, padY, Отступ

-relief, relief, Рельеф

-takefocus, takeFocus, Получение фокуса

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

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

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

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

Этот параметр такой же, как стандартный параметр -background, за исключением того, что его значение также может быть указано как пустая строка. В этом случае виджет отобразит отсутствие фона или рамки, и никакие цвета не будут взяты из его палитры цветов для фона и рамки.

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

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

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

Устанавливает класс для окна. Этот класс будет использоваться при запросе в базе данных параметров для других параметров окна, а также будет использоваться позже для других целей, таких как привязки. Параметр -class не может быть изменён с помощью команды виджета configure.

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

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

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

Устанавливает палитру цветов для окна. Значение может быть либо new, в этом случае для окна и его дочерних элементов создаётся новая палитра цветов, либо имя другого окна (которое должно находиться на том же экране и иметь тот же визуальный режим, что и имяПути), в этом случае новое окно будет использовать палитру цветов из указанного окна. Если параметр -colormap не указан, новое окно использует стандартную палитру цветов своего экрана. Этот параметр не может быть изменён с помощью команды виджета configure.

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

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

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

Значение должно быть булевым. Если значение истинно, это означает, что это окно будет использоваться как контейнер, в котором будет встроено какое-то другое приложение (например, Tk toplevel можно встроить с помощью параметра -use). Окно будет поддерживать соответствующие протоколы менеджера окон для таких вещей, как запросы геометрии. Окно не должно иметь собственных дочерних элементов в этом приложении. Этот параметр не может быть изменён с помощью команды виджета configure.

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

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

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

Устанавливает желаемую высоту окна в любом из форматов, приемлемых для Tk_GetPixels. Если этот параметр меньше или равен нулю, окно не будет запрашивать какой-либо размер.

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

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

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

Устанавливает виджет меню, который будет использоваться как строка меню. На Macintosh строка меню будет отображаться вверху основного монитора. В Microsoft Windows и на всех платформах UNIX меню будет отображаться в окне toplevel как часть оформления окна, поддерживаемого менеджером окон.

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

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

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

Устанавливает экран, на котором нужно разместить новое окно. Можно использовать любое допустимое имя экрана, даже связанное с другим дисплеем. По умолчанию используется тот же экран, что и у родительского окна. Этот параметр является специальным, так как его нельзя указать через базу данных параметров, и его нельзя изменить с помощью команды виджета configure.

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

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

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

Этот параметр используется для встраивания. Если значение не пустая строка, оно должно быть идентификатором окна контейнера, указанным как шестнадцатеричная строка, подобная тем, которые возвращает команда winfo id. Виджет toplevel будет создан как дочерний элемент указанного контейнера вместо корневого окна для экрана. Если окно контейнера находится в приложении Tk, это должно быть окно frame или toplevel, для которого был указан параметр -container. Этот параметр не может быть изменён с помощью команды виджета configure.

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

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

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

Устанавливает визуальную информацию для нового окна в любом из форматов, принимаемых Tk_GetVisual. Если этот параметр не указан, новое окно будет использовать стандартный визуальный режим для своего экрана. Параметр -visual не может быть изменён с помощью команды виджета configure.

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

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

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

Устанавливает желаемую ширину окна в любом из форматов, приемлемых для Tk_GetPixels. Если этот параметр меньше или равен нулю, окно не будет запрашивать какой-либо размер.

Описание

Toplevel похож на frame, за исключением того, что он создаётся как окно верхнего уровня: его родительским X-окном является корневое окно экрана, а не логический родитель из имени пути. Основное назначение toplevel — служить контейнером для диалоговых окон и других наборов виджетов. Единственные видимые элементы toplevel — это цвет фона и необязательная 3D-рамка, чтобы toplevel выглядел поднятым или опущенным.

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

pathName option ?arg arg ...?

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

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

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

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

Привязки

См. также