message

Создание примитива сообщения и управление им.

СИНТАКСИС

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

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

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

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

Имя параметра:-aspect
Имя в Базе:aspect
Класс в Базе:Aspect

Целое число, указывающее желаемые пропорции текста. Его значение равно 100*ширина/высота. Значение "100" - означает, что ширина текста должна равняться его высоте, значение "200" - что текст должен быть вдвое шире по сравнению с высотой, значение "50" - что его высота должна быть вдвое больше ширины и т.д. Используется для определения длины строки, если не задан параметр width. Значение по умолчанию равно "150".

Имя параметра:-justify
Имя в Базе:justify
Класс в Базе:Justify
Имя параметра: -width
Имя в Базе:width
Класс в Базе:Width

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

ОПИСАНИЕ

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

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

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

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

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

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

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

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

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

ПАРАМЕТРЫ ПО УМОЛЧАНИЮ

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