Spec-Zone.ru › Tcl/Tk

Сообщение

ИМЯ
message — Создавать и управлять виджетами текстовых сообщений (неинтерактивные)
СИНОПСИС
СТАНДАРТНЫЕ ПАРАМЕТРЫ
-anchor, anchor, Якорь
-background или -bg, background, Фон
-borderwidth или -bd, borderWidth, Ширина рамки
-cursor, cursor, Указатель
-font, font, Шрифт
-foreground или -fg, foreground, Цвет переднего плана
-highlightbackground, highlightBackground, Фон выделения
-highlightcolor, highlightColor, Цвет выделения
-highlightthickness, highlightThickness, Толщина выделения
-padx, padX, Отступ
-pady, padY, Отступ
-relief, relief, Рельеф
-takefocus, takeFocus, Получение фокуса
-text, text, Текст
-textvariable, textVariable, Переменная
ПАРАМЕТРЫ, СПЕЦИФИЧНЫЕ ДЛЯ ВИДЖЕТА
-aspect, aspect, Соотношение сторон
-justify, justify, Выравнивание
-width, width, Ширина
ОПИСАНИЕ
КОМАНДА ВИДЖЕТА
pathName cget параметр
pathName configure ?параметр? ?значение параметр значение ...?
СВЯЗАННЫЕ ПО УМОЛЧАНИЮ
НЕДОСТАТКИ
СМОТРИТЕ ТАКЖЕ
КЛЮЧЕВЫЕ СЛОВА

Имя

message — Создавать и управлять виджетами текстовых сообщений (неинтерактивные)

Синопсис

message pathName ?options?

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

-anchor, anchor, Якорь
-background или -bg, background, Фон
-borderwidth или -bd, borderWidth, Ширина рамки
-cursor, cursor, Указатель
-font, font, Шрифт
-foreground или -fg, foreground, Цвет переднего плана
-highlightbackground, highlightBackground, Фон выделения
-highlightcolor, highlightColor, Цвет выделения
-highlightthickness, highlightThickness, Толщина выделения
-padx, padX, Отступ
-pady, padY, Отступ
-relief, relief, Рельеф
-takefocus, takeFocus, Получение фокуса
-text, text, Текст
-textvariable, textVariable, Переменная

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

Команда в командной строке: -aspect
Название в базе данных: aspect
Класс в базе данных: Aspect
Указывает целое положительное значение, обозначающее желаемое соотношение сторон для текста. Соотношение сторон задается как 100*ширина/высота. 100 означает, что текст должен быть такой же ширины, как и высоты; 200 означает, что текст должен быть вдвое шире, чем выше; 50 означает, что текст должен быть вдвое выше, чем шире, и так далее. Используется для выбора длины строки текста, если параметр -width не указан. По умолчанию 150.
Команда в командной строке: -justify
Название в базе данных: justify
Класс в базе данных: Justify
Указывает, как выравнивать строки текста. Должно быть одним из значений left, center или right. По умолчанию left. Этот параметр работает совместно с параметрами -anchor, -aspect, -padx, -pady и -width, чтобы обеспечить различные способы расположения текста в окне. Параметры -aspect и -width определяют необходимое количество экранного пространства для отображения текста. Параметры -anchor, -padx и -pady определяют, где эта прямоугольная область отображается в окне виджета, а параметр -justify определяет, как каждая строка отображается в этой прямоугольной области. Например, предположим, что -anchor равен e, а -justify равен left, и что окно сообщения значительно больше, чем необходимо для текста. Текст будет отображаться так, что левые края всех строк выровнены, а правый край самой длинной строки находится в расстоянии -padx от правой стороны окна; весь блок текста будет центрирован по вертикали в окне.
Команда в командной строке: -width
Название в базе данных: width
Класс в базе данных: Width
Указывает длину строк в окне. Значение может иметь любой из форматов, допустимых для Tk_GetPixels. Если значение этого параметра больше нуля, параметр -aspect игнорируется, и параметр -width определяет длину строки. Если значение этого параметра меньше или равно нулю, то параметр -aspect определяет длину строки.

Описание

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

Сообщение — это виджет, который отображает текстовую строку. Виджет сообщения имеет три специальные особенности, которые отличают его от виджета label. Во-первых, он разбивает свою строку на строки, чтобы получить заданное соотношение сторон для окна. Разрывы строк выбираются по границам слов, где это возможно (если ни одно слово не помещается на строке, тогда слово будет разбито на несколько строк). Символы новой строки в строке будут принудительно вызывать разрывы строк; их можно использовать, например, для добавления пустых строк в отображение.

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

Третья особенность виджета сообщения заключается в том, что он специально обрабатывает управляющие символы и символы, которые не печатаются. Символы табуляции заменяются достаточным количеством пробелов, чтобы выровняться по следующей границе в 8 символов. Символы новой строки вызывают разрывы строк. Другие управляющие символы (код ASCII меньше 0x20) и символы, не определенные в шрифте, отображаются как четырёхсимвольная последовательность \xhh, где hh — двухзначное шестнадцатеричное число, соответствующее символу. В редком случае, когда шрифт не содержит всех символов в “0123456789abcdef\x”, управляющие символы и неопределенные символы не отображаются вообще.

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

Команда message создает новую команду Tcl, имя которой pathName. Эта команда может использоваться для вызова различных операций над виджетом. Она имеет следующий общий вид:
pathName option ?arg arg ...?
Параметр и аргументы определяют точное поведение команды. Для виджетов сообщений возможны следующие команды:
pathName cget параметр
Возвращает текущее значение параметра конфигурации, заданного параметром параметр. Параметр может иметь любое значение, принятое командой message.
pathName configure ?параметр? ?значение параметр значение ...?
Запрос или изменение параметров конфигурации виджета. Если параметр не указан, возвращается список, описывающий все доступные параметры для pathName (см. Tk_ConfigureInfo для получения информации о формате этого списка). Если параметр указан без значения, то команда возвращает список, описывающий указанный параметр (этот список будет идентичен соответствующему подсписку возвращаемого значения, если параметр не указан). Если указана одна или несколько пар параметр-значение, то команда изменяет указанный параметр(ы) виджета на заданное(ые) значение(я); в этом случае команда возвращает пустую строку. Параметр может иметь любое значение, принятое командой message.

Связанные по умолчанию

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

Недостатки

Символы табуляции работают не очень хорошо с текстом, который выровнен по центру или правому краю. Чаще всего результатом является неправильное выравнивание строки.

Смотрите также

label

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TkCmd/message.htm

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TkCmd/message.htm

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API