Главная


32. ttk.Entry

Виджет Entry предназначен для того, чтобы позволить пользователю ввести или отредактировать одну строку текста. Это ttk-версия виджета Entry.

Чтобы создать виджет ttk.Entry в качестве дочернего элемента данного виджета parent:

w = ttk.Entry(parent, option=value, ...)

Опции:

Таблица 40. Опции ttk.Entry

class_ Имя класса виджета. Оно может быть указано при создании виджета, но не может быть изменено позже. Для объяснения классов виджетов смотрите Раздел 27, "Стандартизация внешнего вида".
cursor Курсор, который будет появляться при наведении мыши на виджет; см. Раздел 5.8, "Курсоры".
exportselection По умолчанию, если вы выделяете текст в виджете Entry, он автоматически экспортируется в буфер обмена. Чтобы избежать этого экспорта, используйте exportselection=0.
font Используйте эту опцию, чтобы указать шрифт текста, который будет отображаться в виджете; см. Раздел 5.4, "Шрифты". По неясным для автора причинам эта опция не может быть указана со стилем.
invalidcommand Вы можете установить эту опцию в функцию обратного вызова, которая будет вызываться каждый раз, когда проверка не пройдет (то есть когда validatecommand возвращает 0). Смотрите Раздел 10.2, "Добавление проверки в виджет Entry".
justify Эта опция определяет, как будет располагаться текст в области ввода, если он не полностью заполняет область. Значения могут быть tk.LEFT для выравнивания влево; tk.CENTER для выравнивания по центру; или tk.RIGHT для выравнивания вправо.
show Чтобы защитить такие поля, как пароли, от отображения на экране, установите этот параметр в строку, первый символ которой будет заменен на каждый из реальных символов в поле. Например, если поле содержит "sesame", но вы указали show='*', поле будет отображаться как "******".
style Стиль, который будет использоваться при отображении этой кнопки; см. Раздел 49, "Использование и настройка стилей ttk".
takefocus По умолчанию ttk.Entry будет включен в обход фокуса; см. Раздел 53, "Фокус: маршрутизация ввода с клавиатуры". Чтобы удалить виджет из обхода фокуса, используйте takefocus=False.
textvariable Переменная, управляющая текстом, который отображается в области ввода; см. раздел Раздел 52, "Управляющие переменные: значения, скрывающиеся за виджетами".
validate Вы можете использовать эту опцию для указания функции обратного вызова, которая динамически проверяет текстовое содержимое виджета. Смотрите Раздел 10.2, "Добавление проверки в виджет Entry".
validatecommand См. раздел Раздел 10.2, "Добавление валидации в виджет Entry".
width Этот параметр задает ширину области ввода в виде количества символов. Фактическая ширина будет равна этому числу, умноженному на среднюю ширину символа в используемом шрифте. По умолчанию значение равно 20.
xscrollcommand Если виджет имеет связанную горизонтальную полосу прокрутки, установите этот параметр в метод .set этой полосы прокрутки.

Эти параметры виджета tkinter.Entry не поддерживаются конструктором виджета ttk.Entry:

Таблица 41. Опции tkinter.Entry, отсутствующие в ttk.Entry

background или bg Настройте опцию background с помощью стиля; см. [Раздел 47, "Настройка и создание тем и стилей ttk"] (ttk-themes.html). Сокращение bg не поддерживается.
borderwidth или bd Настройте этот параметр с помощью стиля.
disabledbackground Используйте карту стилей для опции background; смотрите Раздел 50.2, "Карты стилей ttk: динамическое изменение внешнего вида".
disabledforeground Используйте карту стилей для опции foreground; смотрите Раздел 50.2, "Карты стилей ttk: динамические изменения внешнего вида".
foreground или fg Настройте эту опцию с помощью стиля.
highlightbackground Чтобы управлять цветом подсветки фокуса, когда кнопка не имеет фокуса, используйте карту стилей для управления опцией highlightcolor; см. Раздел 50.2, "Карты стилей ttk: динамические изменения внешнего вида".
highlightcolor Вы можете указать цвет подсветки фокуса по умолчанию, установив этот параметр в стиле. Вы также можете управлять цветом подсветки фокуса с помощью карты стилей.
highlightthickness Настройте этот параметр с помощью стиля. Эта опция может работать не во всех темах.
insertbackground Не поддерживается.
insertborderwidth Не поддерживается.
insertofftime Не поддерживается.
insertontime Не поддерживается.
insertwidth Не поддерживается.
readonlybackground Используйте карту стилей для управления опцией background; смотрите Раздел 50.2, "Карты стилей ttk: динамическое изменение внешнего вида".
relief Настройте эту опцию с помощью стиля; смотрите Раздел 47, "Настройка и создание тем и стилей ttk".
selectbackground Используйте карту стилей для управления опцией background; смотрите Раздел 50.2, "Карты стилей ttk: динамическое изменение внешнего вида".
selectborderwidth Используйте карту стилей для управления параметром borderwidth; см. Раздел 50.2, "Карты стилей ttk: динамические изменения внешнего вида".
selectforeground Используйте карту стилей для управления опцией foreground; см. Раздел 50.2, "Карты стилей ttk: динамические изменения внешнего вида".

Методы ttk.Entry включают все методы, описанные в разделе 46, "Методы, общие для всех виджетов ttk", плюс все методы виджета Tkinter, описанные в разделе 10, "Виджет Entry".


>> ttk.Frame