<!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN> <html> <head> <title>message</title> </head> <body> <h1>message</h1> <p>Создание примитива сообщения и управление им.</p> <h2><a name=СИНТАКСИС></a>СИНТАКСИС</h2> <pre> <strong>message</strong> <em>имяПути</em> ?<em>параметры</em>? </pre> <h2><a name=СТАНДАРТНЫЕ_ПАРАМЕТРЫ></a>СТАНДАРТНЫЕ ПАРАМЕТРЫ</h2> <ul> <li><strong>-anchor</strong></li> <li><strong>-background</strong></li> <li><strong>-borderwidth</strong></li> <li><strong>-cursor</strong></li> <li><strong>-font</strong></li> <li><strong>-foreground</strong></li> <li><strong>-highlightbackground</strong></li> <li><strong>-highlightcolor</strong></li> <li><strong>-highlightthickness</strong></li> <li><strong>-padx</strong></li> <li><strong>-pady</strong></li> <li><strong>-relief</strong></li> <li><strong>-takefocus</strong></li> <li><strong>-text</strong></li> <li><strong>-textvariable</strong></li> <li><strong>-width</strong></li> </ul> <p>Подробное описание этих параметров приведено в разделе <a href=options.html><strong>options</strong></A>.</p> <h2><a name=ДОПОЛНИТЕЛЬНЫЕ_ПАРАМЕТРЫ_ПРИМИТИВА></a>ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА</h2> <table> <tr><td>Имя параметра:</td><td><strong>-aspect</strong></td></tr> <tr><td>Имя в Базе:</td><td><strong>aspect</strong></td></tr> <tr><td>Класс в Базе:</td><td><strong>Aspect</strong></td></tr> </table> <p>Целое число, указывающее желаемые пропорции текста. Его значение равно 100*ширина/высота. Значение "100" - означает, что ширина текста должна равняться его высоте, значение "200" - что текст должен быть вдвое шире по сравнению с высотой, значение "50" - что его высота должна быть вдвое больше ширины и т.д. Используется для определения длины строки, если не задан параметр width. Значение по умолчанию равно "150".</p> <table> <tr><td>Имя параметра:</td><td><strong>-justify</strong></td></tr> <tr><td>Имя в Базе:</td><td><strong>justify</strong></td></tr> <tr><td>Класс в Базе:</td><td><strong>Justify</strong></td></tr> </table> <table> <tr><td>Имя параметра:</td><td><strong> -width</strong></td></tr> <tr><td>Имя в Базе:</td><td><strong>width</strong></td></tr> <tr><td>Класс в Базе:</td><td><strong>Width</strong></td></tr> </table> <p>Задает желаемую ширину окна (в любом виде, приемлемом для <strong>Tk_GetPixels)</strong>. Если значение параметра положительно, то параметр <strong>aspect</strong> игнорируется, а параметр <strong>width</strong> задает длину строки. Если значение параметра неположительно, то длина строки определяется параметром <strong>aspect</strong>.</p> <h2><a name=ОПИСАНИЕ></a>ОПИСАНИЕ</h2> <p>Команда <strong>message</strong>созадает новое окно (задаваемое аргументом <em>имяПути</em>) и превращает его в примитив сообщения. Детали изображения сообщения, такие как его цвета, шрифт, текст и объемный вид задаются с помощью описанных выше дополнительных параметров. Команда<strong> message </strong>возвращает аргумент <em>имяПути</em>. В момент выполнения этой команды не должно существовать окна с именем <em>имяПути</em>, но должен существовать его предок.</p> <p>Сообщение представляет собой примитив, предназначенный для вывода строки текста. У примитива сообщения есть три специальных свойства. Во-первых, он разбивает строку сообщения на строчки, чтобы обеспечить заданные пропорции окна. Перевод строки осуществляется, по возможности, на границах слов (если в строку не помещается ни одного целого слова, то слово разбивается на несколько строк). Для переноса строки в нее вставляются символы перевода строки; их можно использовать, например, для вывода пустых строчек на экран.</p> <p>Вторым свойством примитива сообщения является возможность выравнивания. Строчки сообщения могут быть выровнены влево (каждая строка начинается от левого края окна), по центру или вправо (каждая строка кончается у правого края окна).</p> <p>Третье свойство примитива сообщения состоит в том, что он специальным образом обрабатывает управляющие символы и непечатные символы. Символы табуляции заменяются пробелами, число которых равно расстоянию до ближайшего кратного 8-ми символам. Символы перевода строки вызывают переход на новую строку. Другие управляющие символы (код ASCII которых меньше 0x20) и символы, не определенные в шрифте сообщения, выводятся в виде последовательности из четырех символов \xhh, где hh это две шестнадцатиричные цифры, представляющие собой ASCII код данного символа. В том редком случае, когда в шрифте отсутствуют некоторые из символов "0123456789abcdef\x" управляющие символы и неопределенные символы вообще не выводятся.</p> <h2><a name=КОМАНДА_ПРИМИТИВА></a>КОМАНДА ПРИМИТИВА</h2> <p>Команда<strong> message </strong>создает новую команду Tcl с именем <em>имяПути</em>. С помощью этой команды можно выполнять различные операции над примитивом. Ее общий вид</p> <pre> имяПути параметр ?арг арг ...? </pre> <p><em>Параметр</em> и <em>арг</em>ументы уточняют поведение команды. Примитивы сообщения допускают следующие формы команды</p> <dl> <dt><em>имяПути</em> <strong>cget</strong> <em>параметр</em></dt> <dd>Возвращает текущее значение параметра конфигурации с именем <em>параметр</em>.<em>Параметр</em> может быть любым из параметров команды <strong>message</strong>. </dd> <dt><em>имяПути</em> <strong>configure</strong> <em>параметр</em> ?<em>значение параметр значение ...</em>?</dt> <dd>Запрашивает значения параметров конфигурации примитива или изменяет их. Если <em>параметр</em> не указан, то возвращает список, содержащий значения всех допустимых в<em>имениПути</em> параметров (формат списка описан в <strong>Tk_ConfigureInfo</strong>). Если <em>параметр</em> задан, а его новое <em>значение</em> нет, то команда возвращает часть полного списка, относящуюся к указанному параметру. Если заданы одна или несколько пар <em>параметр-значение</em>, то указанным <em>параметр</em>ам примитива присваиваются новые <em>значения</em>, а команда возвращает пустую строку. <em>Параметр</em> может быть любым из параметров команды <strong>message</strong> . </dd> </dl> <h2><a name=ПАРАМЕТРЫ_ПО_УМОЛЧАНИЮ></a>ПАРАМЕТРЫ ПО УМОЛЧАНИЮ</h2> <p> При создании сообщения параметры по умолчанию отсутствуют: сообщения предназначены только для вывода текста. </p> </body> </html>