Главная


12. Виджет Label

Виджеты Label могут отображать одну или несколько строк текста в одном стиле, растровое изображение или картинку. Чтобы создать виджет метки в корневом окне или фрейме parent:

w = tk.Label(parent, option, ...)

Конструктор возвращает новый виджет Label. Опции включают:

Таблица 20. Опции виджета Label

activebackground Цвет фона, который будет отображаться при наведении курсора мыши на виджет.
activeforeground Цвет переднего плана, который будет отображаться при наведении курсора мыши на виджет.
anchor Эта опция определяет, где будет располагаться текст, если виджет имеет больше места, чем требуется для текста. По умолчанию используется anchor=tk.CENTER, который центрирует текст в доступном пространстве. Другие значения см. в Раздел 5.5, "Якоря". Например, если вы используете anchor=tk.NW, текст будет позиционирован в левом верхнем углу доступного пространства.
bg или background Цвет фона метки. См. раздел Раздел 5.3, "Цвета".
bitmap Установите этот параметр равным битовому изображению или объекту изображения, и метка будет отображать эту графику. См. Раздел 5.7, " Битовые изображения" и Раздел 5.9, " Изображения".
bd или borderwidth Ширина границы вокруг метки; см. раздел Раздел 5.1, "Размеры". Значение по умолчанию - два пикселя.
compound Если вы хотите, чтобы виджет Label отображал и текст, и графику ( битовое изображение или картинку), опция compound задает относительную ориентацию графики относительно текста. Значениями могут быть любые из tk.LEFT, tk.RIGHT, tk.CENTER, tk.BOTTOM или tk.TOP. Например, если вы укажете compound=BOTTOM, графика будет отображаться под текстом.
cursor Курсор, который появляется при наведении мыши на эту метку. См. раздел Раздел 5.8, "Курсоры".
disabledforeground Цвет переднего плана, который будет отображаться, когда state виджета будет tk.DISABLED.
font Если вы отображаете текст в этом ярлыке (с помощью опции text или textvariable), опция font указывает, каким шрифтом будет отображаться текст. См. раздел Раздел 5.4, "Шрифты".
fg или foreground Если вы отображаете текст или растровое изображение в этой метке, этот параметр задает цвет текста. Если вы отображаете битмап, это цвет, который будет отображаться в позиции 1-битов в битмапе. См. Раздел 5.3, "Цвета".
height Высота метки в строках (не пикселях!). Если этот параметр не задан, размер метки будет соответствовать ее содержимому.
highlightbackground Цвет выделения фокуса, когда виджет не имеет фокуса.
highlightcolor Цвет подсветки фокуса, когда виджет имеет фокус.
highlightthickness Толщина выделения фокуса.
image Чтобы отобразить статическое изображение в виджете Label, установите этот параметр для объекта image. См. Раздел 5.9, "Изображения".
justify Указывает, как несколько строк текста будут выровнены относительно друг друга: tk.LEFT для выравнивания по левому краю, tk.CENTER для выравнивания по центру (по умолчанию), или tk.RIGHT для выравнивания по правому краю.
padx Дополнительное пространство, добавляемое слева и справа от текста внутри виджета. По умолчанию равно 1.
pady Дополнительное пространство, добавляемое над и под текстом виджета. По умолчанию равно 1.
relief Задает вид декоративной границы вокруг метки. По умолчанию используется tk.FLAT; другие значения см. в Раздел 5.6, "Стили рельефа".
state По умолчанию виджет находится в состоянии tk.NORMAL. Установите этот параметр в значение tk.DISABLED, чтобы сделать его не реагирующим на события мыши. Состояние будет tk.ACTIVE, когда мышь будет находиться над виджетом.
takefocus Обычно фокус не перемещается по виджетам Label; смотрите Раздел 53, "Фокус: маршрутизация ввода с клавиатуры". Если вы хотите, чтобы этот виджет посещал фокус, установите takefocus=1.
text Чтобы отобразить одну или несколько строк текста в виджете метки, установите этот параметр в строку, содержащую текст. Внутренние новые строки ('\n') будут принудительно разрывать строку.
textvariable Чтобы подключить текст, отображаемый в виджете метки, к управляющей переменной класса StringVar, установите этот параметр для этой переменной. См. Раздел 52, "Управляющие переменные: значения, скрывающиеся за виджетами".
underline Вы можете отобразить подчеркивание (_) под n-ой буквой текста, считая от 0, установив этот параметр равным n. По умолчанию underline=-1, что означает отсутствие подчеркивания.
width Ширина метки в символах (не пикселях!). Если эта опция не задана, размер метки будет соответствовать ее содержимому.
wraplength Вы можете ограничить количество символов в каждой строке, установив этот параметр на нужное число. Значение по умолчанию, 0, означает, что строки будут разрываться только на новых строках.

Для виджетов Label не существует специальных методов, кроме общепринятых (см. Раздел 26, "Универсальные методы виджетов").


>> Виджет LabelFrame