242 lines
9.7 KiB
HTML
242 lines
9.7 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<title>toplevel</title>
|
||
</head>
|
||
<body>
|
||
<h1>toplevel</h1>
|
||
|
||
<p>Создание примитива верхнего уровня и управление им.</p>
|
||
|
||
<h2><a name="СИНТАКСИС"></a>СИНТАКСИС</h2>
|
||
|
||
<pre>
|
||
<strong>toplevel</strong> <em>имяПути</em> ?<em>параметры</em>?
|
||
</pre>
|
||
|
||
|
||
<h2><a name="СТАНДАРТНЫЕ_ПАРАМЕТРЫ"></a>СТАНДАРТНЫЕ ПАРАМЕТРЫ</h2>
|
||
|
||
<ul>
|
||
<li><strong>-background</strong></li>
|
||
<li><strong>-cursor</strong></li>
|
||
<li><strong>-highlightbackground</strong></li>
|
||
<li><strong>-highlightcolor</strong></li>
|
||
<li><strong>-highlightthickness</strong></li>
|
||
<li><strong>-relief</strong></li>
|
||
<li><strong>-takefocus</strong></li>
|
||
</ul>
|
||
|
||
|
||
<p>Подробное описание этих параметров приведено в разделе <a
|
||
href="options.html"><strong>options</strong></a>.</p>
|
||
|
||
<h2><a name="ДОПОЛНИТЕЛЬНЫЕ_ПАРАМЕТРЫ_ПРИМИТИВА"></a>ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА</h2>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-background</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>background</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Background</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Этот параметр по смыслу совпадает со стандартным параметром
|
||
<strong>background</strong> за исключением того, что его
|
||
значением может являться и пустая строка. В последнем случае при
|
||
выводе примитива не появляется ни фона, ни бордюра, и для них не
|
||
используется ни одна из красок его палитры.</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-class</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>class</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Class</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Задает класс окна. Этот класс используется при запросах базы
|
||
данных параметров о значениях других параметров примитива; а
|
||
также при определении привязок. Параметр <strong>-class</strong>
|
||
нельзя переопределить командой примитива
|
||
<strong>configure</strong>.</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-colormap</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>colormap</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Colormap</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Задает палитру, используемую в окне. Значением параметра может
|
||
быть либо <strong>new</strong> (и в этом случае для данного окна
|
||
и его потомков создается новая палитра), либо имя другого окна
|
||
(которое должно находиться на том же экране и иметь то же
|
||
значение параметра <strong>-visual</strong>, что и
|
||
<em>имяПути</em>). Если параметр <strong>-colormap</strong> не
|
||
задан, то новое окно использует палитру экрана по
|
||
умолчанию. Параметр <strong>-colormap</strong> нельзя
|
||
переопределить командой примитива
|
||
<strong>configure</strong>.</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-container</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>container</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Container</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Значение параметра должно быть булевским. Если его значение
|
||
истина, то окно будет использоваться в качестве контейнера, в
|
||
который будет вставляться некоторое другое приложение (например,
|
||
можно вставить примитив верхнего уровня Tk с помощью параметра
|
||
-use). Окно будет поддерживать соответствующие протоколы
|
||
управления окнами, например, для обработки геометрических
|
||
запросов. Параметр <strong>-container</strong> нельзя
|
||
переопределить командой примитива
|
||
<strong>configure</strong>.</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-height</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>height</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Height</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Задает желаемую высоту окна в любом виде, приемлемом для
|
||
<strong>Tk_GetPixels.</strong> Если введенное значение
|
||
неположительно, то место для окна вообще не запрашивается.</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-menu</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>menu</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Menu</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Задает примитив меню, используемый в качестве полосы меню. На
|
||
Macintosh полоса меню будет выведена вверху основного
|
||
монитора. В Microsoft Windows и на всех платформах UNIX меню
|
||
выводится поверх окна верхнего уровня как деталь оформления окна
|
||
менеджером окон.</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-screen</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td></td></tr>
|
||
<tr><td>Класс в Базе:</td><td></td></tr>
|
||
</table>
|
||
|
||
<p>Задает экран, на котором следует разместить новое окно. Может
|
||
быть использовано произвольное допустимое имя экрана, в том
|
||
числе и отличное от текущего. По умолчанию значением является
|
||
имя текущего экрана. Параметр <strong>-screen</strong> является
|
||
специальным и его нельзя переопределить командой примитива
|
||
<strong>configure</strong>.</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-use</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>use</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Use</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Используется для вставки. Если значение параметра отлично от
|
||
пустой строки, то оно должно быть идентификатором
|
||
окна-контейнера, заданным в виде шестнадцатиричной строки, в том
|
||
виде, в котором возвращает результат команда <strong>window
|
||
id</strong>. Примитив верхнего уровня будет создаваться как
|
||
непосредственный потомок указанного контейнера, а не корневого
|
||
окна экрана. Если окно-контейнер содержится в приложении Tk, то
|
||
оно должно быть либо рамкой, либо примитивом верхнего уровня,
|
||
для которого задан параметр
|
||
<strong>-container</strong>. Параметр <strong>-use</strong>
|
||
нельзя переопределить командой примитива
|
||
<strong>configure</strong>.</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-visual</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>visual</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Visual</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Задает внешний вид окна в любом виде, приемлемом для
|
||
<strong>Tk_GetVisual</strong>. Если параметр не задан, то
|
||
используется его значение по умолчанию для экрана. Параметр
|
||
<strong>-visual</strong> нельзя переопределить командой примитива
|
||
<strong>configure</strong>.</p>
|
||
|
||
<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>. Если введенное значение
|
||
неположительно, то место для окна вообще не запрашивается. </p>
|
||
|
||
<h2><a name="ОПИСАНИЕ"></a>ОПИСАНИЕ</h2>
|
||
|
||
<p>Команда <strong>toplevel</strong> создает новый примитив
|
||
верхнего уровня (задаваемый аргументом <em>имяПути</em>). Детали
|
||
изображения примитива верхнего уровня, такие как цвет его фона и
|
||
объемный вид, задаются с помощью описанных выше дополнительных
|
||
параметров. Команда <strong>toplevel</strong> возвращает
|
||
аргумент <em>имяПути</em>.</p>
|
||
|
||
<p>Примитив верхнего уровня похож на рамку; отличие состоит в том,
|
||
что он создается как окно верхнего уровня: его непосредственным
|
||
X предком является корневое окна экрана, а не логический предок,
|
||
определяемый именем пути. Основная задача примитива верхнего
|
||
уровня служить контейнером для диалоговых окон и других наборов
|
||
примитивов. Единственными параметрами вывода примитива верхнего
|
||
уровня являются цвет его фона и необязательный трехмерный
|
||
бордюр, который позволяет примитиву выглядеть выпуклым или
|
||
вдавленным.</p>
|
||
|
||
|
||
<h2><a name="КОМАНДА_ПРИМИТИВА"></a>КОМАНДА ПРИМИТИВА</h2>
|
||
|
||
|
||
<p>Команда <strong>toplevel</strong> создает новую команду Tcl,
|
||
имя которой совпадает с именем окна примитива верхнего уровня. С
|
||
помощью этой команды можно выполнять различные операции над
|
||
примитивом. Ее общий вид </p>
|
||
|
||
<pre>
|
||
имяПути параметр арг арг ...
|
||
</pre>
|
||
|
||
<p><em>имяПути</em> является именем команды, которое совпадает с
|
||
именем пути примитива верхнего уровня. <em>Параметр</em> и
|
||
<em>арг</em>ументы уточняют поведение команды.</p>
|
||
|
||
|
||
<p>Примитивы верхнего уровня допускают следующие команды:</p>
|
||
|
||
<dl>
|
||
<dt><em>имяПути</em> <strong>cget</strong> <em>параметр</em></dt>
|
||
|
||
<dd>Возвращает текущее значение параметра конфигурации с именем
|
||
<em>параметр</em>. Параметр может быть любым из параметров
|
||
команды <strong>toplevel</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>toplevel</strong>.</dd>
|
||
</dl>
|
||
|
||
<h2><a name="ПРИВЯЗКИ"></a>ПРИВЯЗКИ</h2>
|
||
|
||
<p>При создании примитива верхнего уровня никаких привязок не
|
||
создается: эти примитивы не предполагаются интерактивными.</p>
|
||
|
||
</body>
|
||
</html>
|
||
|
||
|
||
|