label

Команда создает и управляет примитивами ярлыков.

СИНТАКСИС

      label имяПути ?параметры?
    

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

• -anchor
• -background
• -bitmap
• -borderwidth
• -cursor
• -font
• -foreground
• -highlightbackground
• -highlightcolor
• -highlightthickness
• -image
• -justify
• -padx
• -pady
• -relief
• -takefocus
• -text
• -textvariable
• -underline
• -wraplength

Подробное описание этих параметров приведено в разделе oрtions.

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА

Задает желаемую высоту ярлыка. Если в ярлыке выводится изображение или двуцветное изображение, то значение параметра задается в пикселях (т.е., в любом виде, приемлемом для Tk_GetPixels); высота текстового ярлыка задается числом строчек текста. Если параметр не задан, то высота ярлыка вычисляется по его содержимому.

Задает желаемую ширину ярлыка. Если в ярлыке выводится изображение или двуцветное изображение, то значение параметра задается в пикселях (т.е., в любом виде, приемлемом для Tk_GetPixels); ширина текстового ярлыка задается числом символов. Если параметр не задан, то ширина ярлыка вычисляется по его содержимому.

ОПИСАНИЕ

Команда label создает новое окно (задаваемое аргументом имяПути) и превращает его в примитив ярлыка. Детали изображения ярлыка, такие как его цвета, шрифт, текст и исходный объемный вид задаются с помощью описанных выше дополнительных параметров. Команда label возвращает аргумент имяПути. В момент выполнения этой команды не должно существовать окна с именем имяПути, но должен существовать его предок.

Ярлык представляет собой примитив, в котором выводится текстовая строка, изображение или двуцветное изображение. Весь выводимый текст должен быть записан одним шрифтом, однако он может занимать несколько строчек на экране (если в нем есть символы перевода строки или задан параметр wrapLength). Один из символов текста может быть подчеркнут (в соответствии со значением параметра underline). Есть несколько простых способов управления ярлыком (например, изменения его формы или редактирования текста в нем), они описаны ниже.

КОМАНДА ПРИМИТИВА

Команда label создает новую команду Tcl с именем имяПути. С помощью этой команды можно выполнять различные операции над примитивом. Ее общий вид

      имяПути параметр ?арг арг ...?
    

Параметр и аргументы уточняют поведение команды. Примитивы ярлыка допускают следующие формы команды:

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

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

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

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

ПРИВЯЗКИ

При создании нового ярлыка он не имеет привязок по умолчанию: ярлыки не предполагаются интерактивными.