2018-02-05 17:22:04 +03:00
|
|
|
|
<!DOCTYPE html PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<html>
|
|
|
|
|
|
<head>
|
|
|
|
|
|
<title>toplevel</title>
|
|
|
|
|
|
</head>
|
|
|
|
|
|
<body>
|
|
|
|
|
|
<h1>toplevel</h1>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Создание примитива верхнего уровня и управление им.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<h2><a name=СИНТАКСИС></a>СИНТАКСИС</h2>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<pre>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<strong>toplevel</strong> <em>имяПути</em> ?<em>параметры</em>?
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<h2><a name=СТАНДАРТНЫЕ_ПАРАМЕТРЫ></a>СТАНДАРТНЫЕ ПАРАМЕТРЫ</h2>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<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>
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Подробное описание этих параметров приведено в разделе <a
|
|
|
|
|
|
href=options.html><strong>options</strong></a>.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<h2><a name=ДОПОЛНИТЕЛЬНЫЕ_ПАРАМЕТРЫ_ПРИМИТИВА></a>ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ ПРИМИТИВА</h2>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Этот параметр по смыслу совпадает со стандартным параметром
|
|
|
|
|
|
<strong>background</strong> за исключением того, что его
|
|
|
|
|
|
значением может являться и пустая строка. В последнем случае при
|
|
|
|
|
|
выводе примитива не появляется ни фона, ни бордюра, и для них не
|
|
|
|
|
|
используется ни одна из красок его палитры.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Задает класс окна. Этот класс используется при запросах базы
|
|
|
|
|
|
данных параметров о значениях других параметров примитива; а
|
|
|
|
|
|
также при определении привязок. Параметр <strong>-class</strong>
|
|
|
|
|
|
нельзя переопределить командой примитива
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<strong>configure</strong>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Задает палитру, используемую в окне. Значением параметра может
|
|
|
|
|
|
быть либо <strong>new</strong> (и в этом случае для данного окна
|
|
|
|
|
|
и его потомков создается новая палитра), либо имя другого окна
|
|
|
|
|
|
(которое должно находиться на том же экране и иметь то же
|
|
|
|
|
|
значение параметра <strong>-visual</strong>, что и
|
|
|
|
|
|
<em>имяПути</em>). Если параметр <strong>-colormap</strong> не
|
|
|
|
|
|
задан, то новое окно использует палитру экрана по
|
|
|
|
|
|
умолчанию. Параметр <strong>-colormap</strong> нельзя
|
|
|
|
|
|
переопределить командой примитива
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<strong>configure</strong>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Значение параметра должно быть булевским. Если его значение
|
|
|
|
|
|
истина, то окно будет использоваться в качестве контейнера, в
|
|
|
|
|
|
который будет вставляться некоторое другое приложение (например,
|
|
|
|
|
|
можно вставить примитив верхнего уровня Tk с помощью параметра
|
|
|
|
|
|
-use). Окно будет поддерживать соответствующие протоколы
|
|
|
|
|
|
управления окнами, например, для обработки геометрических
|
|
|
|
|
|
запросов. Параметр <strong>-container</strong> нельзя
|
|
|
|
|
|
переопределить командой примитива
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<strong>configure</strong>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Задает желаемую высоту окна в любом виде, приемлемом для
|
|
|
|
|
|
<strong>Tk_GetPixels.</strong> Если введенное значение
|
|
|
|
|
|
неположительно, то место для окна вообще не запрашивается.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Задает примитив меню, используемый в качестве полосы меню. На
|
|
|
|
|
|
Macintosh полоса меню будет выведена вверху основного
|
|
|
|
|
|
монитора. В Microsoft Windows и на всех платформах UNIX меню
|
|
|
|
|
|
выводится поверх окна верхнего уровня как деталь оформления окна
|
|
|
|
|
|
менеджером окон.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<tr><td>Имя параметра:</td><td><strong>-screen</strong></td></tr>
|
|
|
|
|
|
<tr><td>Имя в Базе:</td><td></td></tr>
|
|
|
|
|
|
<tr><td>Класс в Базе:</td><td></td></tr>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Задает экран, на котором следует разместить новое окно. Может
|
|
|
|
|
|
быть использовано произвольное допустимое имя экрана, в том
|
|
|
|
|
|
числе и отличное от текущего. По умолчанию значением является
|
|
|
|
|
|
имя текущего экрана. Параметр <strong>-screen</strong> является
|
|
|
|
|
|
специальным и его нельзя переопределить командой примитива
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<strong>configure</strong>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Используется для вставки. Если значение параметра отлично от
|
|
|
|
|
|
пустой строки, то оно должно быть идентификатором
|
|
|
|
|
|
окна-контейнера, заданным в виде шестнадцатиричной строки, в том
|
|
|
|
|
|
виде, в котором возвращает результат команда <strong>window
|
|
|
|
|
|
id</strong>. Примитив верхнего уровня будет создаваться как
|
|
|
|
|
|
непосредственный потомок указанного контейнера, а не корневого
|
|
|
|
|
|
окна экрана. Если окно-контейнер содержится в приложении Tk, то
|
|
|
|
|
|
оно должно быть либо рамкой, либо примитивом верхнего уровня,
|
|
|
|
|
|
для которого задан параметр
|
|
|
|
|
|
<strong>-container</strong>. Параметр <strong>-use</strong>
|
|
|
|
|
|
нельзя переопределить командой примитива
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<strong>configure</strong>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Задает внешний вид окна в любом виде, приемлемом для
|
|
|
|
|
|
<strong>Tk_GetVisual</strong>. Если параметр не задан, то
|
|
|
|
|
|
используется его значение по умолчанию для экрана. Параметр
|
|
|
|
|
|
<strong>-visual</strong> нельзя переопределить командой примитива
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<strong>configure</strong>.</p>
|
|
|
|
|
|
|
|
|
|
|
|
<table>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</table>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<h2><a name=КОМАНДА_ПРИМИТИВА></a>КОМАНДА ПРИМИТИВА</h2>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Команда <strong>toplevel</strong> создает новую команду Tcl,
|
|
|
|
|
|
имя которой совпадает с именем окна примитива верхнего уровня. С
|
|
|
|
|
|
помощью этой команды можно выполнять различные операции над
|
|
|
|
|
|
примитивом. Ее общий вид </p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<pre>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
имяПути параметр арг арг ...
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</pre>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p><em>имяПути</em> является именем команды, которое совпадает с
|
|
|
|
|
|
именем пути примитива верхнего уровня. <em>Параметр</em> и
|
|
|
|
|
|
<em>арг</em>ументы уточняют поведение команды.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Примитивы верхнего уровня допускают следующие команды:</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dl>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</dl>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<h2><a name=ПРИВЯЗКИ></a>ПРИВЯЗКИ</h2>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>При создании примитива верхнего уровня никаких привязок не
|
|
|
|
|
|
создается: эти примитивы не предполагаются интерактивными.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
|
