296 lines
11 KiB
HTML
296 lines
11 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<title>place</title>
|
||
</head>
|
||
<body>
|
||
|
||
<h1>place</h1>
|
||
|
||
<p>Геометрический менеджер, обеспечивающий размещение виджетов в
|
||
абсолютных или относительных координатах.</p>
|
||
|
||
<h2><a name="СИНТАКСИС"></a>СИНТАКСИС</h2>
|
||
|
||
<pre>
|
||
<strong>place</strong> <em>window option value</em> ?<em>option value ...</em>?
|
||
<strong>place configure</strong> <em>window option value</em> ?<em>option value ...</em>?
|
||
<strong>place forget</strong> <em>window</em>
|
||
<strong>place info</strong> <em>window</em>
|
||
<strong>place slaves</strong> <em>window</em>
|
||
</pre>
|
||
|
||
|
||
<h2><a name="ОПИСАНИЕ"></a>ОПИСАНИЕ</h2>
|
||
|
||
<p>Геометрический менеджер <strong>place</strong> позволяет
|
||
размещать виджеты в их мастер-окнах, используя прямые указания о
|
||
размерах и размещении виджета. Кроме того, с его помощью можно
|
||
добиваться режима "резинового листа", указывая размеры и
|
||
размещение виджета в долях размера мастер-окна. При этом виджеты
|
||
изменяют свои размеры при изменении размеров мастер окна. И,
|
||
наконец, менеджер place позволяет сочетать оба этих метода,
|
||
размещая, например, виджет определенного размера в центре
|
||
мастер-окна.</p>
|
||
|
||
<p>Команда <strong>place</strong> используется для управления
|
||
соответствующим геометрическим менеджером и для получения от
|
||
него справочной информации. Команда может иметь перечисленные
|
||
ниже формы.</p>
|
||
|
||
<dl>
|
||
<dt><strong>place</strong> <em>window option value</em>
|
||
?<em>option value ...</em></dt>
|
||
|
||
<dd>Если первый аргумент команды является именем окна (любая
|
||
величина, начинающаяся с "."), команда выполняется
|
||
точно так же, как команда <strong>place
|
||
configure</strong>.</dd>
|
||
|
||
<dt><strong>place configure</strong> <em>window option
|
||
value</em> ?<em>option value ...</em></dt>
|
||
|
||
<dd><p>Аргумент команды состоит из имени размещаемого виджета,
|
||
после которого идут пары аргументов, состоящих из имени
|
||
опции и ее значения. Если виджет уже обрабатывался с помощью
|
||
команды <strong>place</strong>, то для не определенных в
|
||
команде опций будут использоваться старые значения, а не
|
||
значения по умолчанию. Команда возвращает пустую строку</p>
|
||
|
||
<p>Ниже перечислены возможные опции.</p>
|
||
|
||
<dl>
|
||
<dt><strong>-in</strong> <em>master</em></dt>
|
||
|
||
<dd>Аргумент <em>master</em> определяет полное имя виджета
|
||
(мастер-окна), относительно которого будет размещаться
|
||
виджет window. Мастер-окно должно быть непосредственным
|
||
предком виджета, или потомком этого предка. При этом они
|
||
оба должны быть потомками одного и того же
|
||
toplevel-окна. Эти ограничения необходимы, чтобы
|
||
гарантировать, что виджет будет виден, когда видно
|
||
мастер-окно. По умолчанию виджет размещается в своем
|
||
непосредственном предке.</dd>
|
||
|
||
<dt><strong>-x</strong> <em>location</em></dt>
|
||
|
||
<dd><p>Аргумент <em>location</em> определяет
|
||
<em>x</em>-координату в мастер-окне для якорной точки
|
||
виджета. Координата указывается на экране в одной из
|
||
следующих форм:</p>
|
||
|
||
<ul>
|
||
<li>в пикселях (число),</li>
|
||
|
||
<li>в сантиметрах (число с буквой <strong>c</strong> на
|
||
конце),</li>
|
||
|
||
<li>в миллиметрах (число с буквой <strong>m</strong> на
|
||
конце),</li>
|
||
|
||
<li>в дюймах (число с буквой <strong>i</strong> на
|
||
конце)</li>
|
||
|
||
<li>в точках (число с буквой <strong>p</strong>на конце,
|
||
точка равна 1/72 дюйма).</li>
|
||
</ul>
|
||
|
||
<p>Якорная точка не обязана находиться внутри мастер-окна.</p>
|
||
</dd>
|
||
|
||
<dt><strong>-relx</strong> <em>location</em></dt>
|
||
|
||
<dd>Аргумент <em>location</em> определяет
|
||
<em>x</em>-координату в мастер окне для якорной точки
|
||
виджета. Координата указывается на экране в виде
|
||
десятичного числа в долях соответствующего размера
|
||
мастер-окна. Так "0.0" соответствует левому краю
|
||
мастер окна, "1.0" правому краю. Если указаны
|
||
обе опции, <strong>-x</strong> и
|
||
<strong>-relx</strong>, то соответствующие величины
|
||
складываются. Например, <strong>-relx 0.5 -x -2</strong>
|
||
помещает якорную точку на два пикселя левее центра
|
||
мастер-окна.</dd>
|
||
|
||
<dt><strong>-y</strong> <em>location</em></dt>
|
||
|
||
<dd><p>Аргумент <em>location</em> определяет y-координату в
|
||
мастер-окне для якорной точки виджета. Координата
|
||
указывается на экране в одной из следующих форм:</p>
|
||
|
||
<ul>
|
||
<li>в пикселях (число),</li>
|
||
|
||
<li>в сантиметрах (число с буквой <strong>c</strong> на
|
||
конце),</li>
|
||
|
||
<li>в миллиметрах (число с буквой <strong>m</strong> на
|
||
конце),</li>
|
||
|
||
<li>в дюймах (число с буквой <strong>i</strong> на
|
||
конце),</li>
|
||
|
||
<li>в точках (число с буквой <strong>i</strong> на
|
||
конце, точка равна 1/72 дюйма).</li>
|
||
</ul>
|
||
|
||
<p>Якорная точка не обязана находиться
|
||
внутри мастер-окна.</p>
|
||
</dd>
|
||
|
||
<dt><strong>-rely</strong> <em>location</em></dt>
|
||
|
||
<dd>Аргумент <em>location</em> определяет
|
||
<em>y</em>-координату в мастер-окне для якорной точки
|
||
виджета. Координата указывается на экране в виде
|
||
десятичного числа в долях соответствующего размера
|
||
мастер-окна. Так "0.0" соответствует верхнему
|
||
краю мастер-окна, "1.0" нижнему краю. Если
|
||
указаны обе опции, <strong>-y</strong> и
|
||
<strong>-rely</strong>, то соответствующие величины
|
||
складываются. Например, <strong>-rely 0.5 -y -3</strong>
|
||
помещает якорную точку на три пикселя ниже центра
|
||
мастер-окна.</dd>
|
||
|
||
<dt><strong>-anchor</strong> <em>where</em></dt>
|
||
|
||
<dd>Аргумент <em>where</em> определяет, какая точка виджета
|
||
будет помещена в якорной точке, заданной с помощью опций
|
||
<strong>-x</strong>, <strong>-y</strong>,
|
||
<strong>-relx</strong> и <strong>-rely</strong>. В якорную
|
||
точку помещается крайняя точка виджета (включая границу,
|
||
если она задана). Так значение <strong>se</strong>
|
||
означает, что в якорную точку будет помещен нижний правый
|
||
угол виджета. Значение по умолчанию
|
||
<strong>nw</strong>.</dd>
|
||
|
||
<dt><strong>-width</strong> <em>size</em></dt>
|
||
|
||
<dd>Аргумент <em>size</em> определяет ширину виджета на
|
||
экране (допустимы те же формы, что и для опций
|
||
<strong>-x</strong>и <strong>-y</strong>). Ширина это
|
||
внешняя ширина виджета, включая его границу (если она
|
||
задана). Если аргумент представляет собой пустую строку
|
||
или если ни опция <strong>-width</strong>, ни опция
|
||
<strong>-relwidth</strong> не определены, ширина виджета
|
||
определяется исходя из его собственных запросов.</dd>
|
||
|
||
<dt><strong>-relwidth</strong> <em>size</em></dt>
|
||
|
||
<dd>Аргумент <em>size</em> определяет ширину виджета на
|
||
экране. Ширина указывается в виде десятичного числа в
|
||
долях соответствующего размера мастер-окна. Так 0.5
|
||
соответствует ширине в половину ширины мастер-окна. Если
|
||
указаны обе опции, <strong>-width</strong> и
|
||
<strong>-relwidth</strong>, то соответствующие величины
|
||
складываются. Например, <strong>-relwidth 1.0 -width
|
||
5</strong> делает виджет на 5 пикселей шире
|
||
мастер-окна.</dd>
|
||
|
||
<dt><strong>-height</strong> <em>size</em></dt>
|
||
|
||
<dd>Аргумент <em>size</em> определяет высоту виджета на
|
||
экране (допустимы те же формы, что и для опций
|
||
<strong>-x</strong>и <strong>-y</strong>). Высота это
|
||
внешняя высота виджета, включая его границу (если она
|
||
задана). Если аргумент представляет собой пустую строку
|
||
или если ни опция <strong>-height</strong>, ни опция
|
||
<strong>-relheight</strong> не определены, высота виджета
|
||
определяется исходя из его собственных запросов.</dd>
|
||
|
||
<dt><strong>-relheight</strong> <em>size</em></dt>
|
||
|
||
<dd>Аргумент <em>size</em> определяет высоту виджета на
|
||
экране. Высота указывается в виде десятичного числа в
|
||
долях соответствующего размера мастер-окна. Так
|
||
"0.5" соответствует высоте в половину высоты
|
||
мастер-окна. Если указаны обе опции,
|
||
<strong>-height</strong> и <strong>-relheight</strong>, то
|
||
соответствующие величины складываются. Например,
|
||
<strong>-relheight 1.0 -height -2</strong> делает виджет
|
||
на 2 пикселя ниже мастер-окна.</dd>
|
||
|
||
<dt><strong>-bordermode</strong> <em>mode</em></dt>
|
||
|
||
<dd><p>Аргумент <em>mode</em> определяет, используются ли
|
||
границы мастер-окна при определении положения
|
||
размещаемого виджета.</p>
|
||
|
||
<p>Значение по умолчанию, которое используется наиболее
|
||
часто, <strong>inside</strong>. Оно означает, что
|
||
менеджер рассматривает в качестве мастер-окна его
|
||
внутреннюю часть без границы. Опция <strong>-x
|
||
0</strong> означает при этом точку внутри границы
|
||
мастер-окна. А опция <strong>-relwidth 1.0</strong>
|
||
означает, что виджет будет размещен внутри
|
||
соответствующих границ мастер-окна.</p>
|
||
|
||
<p>Значение <strong>outside</strong> означает, что
|
||
менеджер включает границу мастер-окна в его состав. Это
|
||
значение используется обычно, когда нужно разместить
|
||
виджет вне его мастер-окна (но в пределах границы
|
||
мастер-окна), например, как при опциях <strong>-x 0 -y 0
|
||
-anchor ne</strong>.</p>
|
||
|
||
<p>Значение <strong>ignore</strong> означает, что менеджер
|
||
включает в состав окна все внутренние границы, но не
|
||
внешние границы (его официальное X-определение). Это
|
||
значение используется, вероятно, реже остальных.</p>
|
||
</dd>
|
||
</dl>
|
||
</dd>
|
||
</dl>
|
||
|
||
|
||
<h2><a name="ЗАМЕЧАНИЕ"></a>ЗАМЕЧАНИЕ</h2>
|
||
|
||
<p>Если значение одной и той же величины определено дважды с
|
||
использованием различных опций, например, если x-координата
|
||
виджета определена сначала с использованием опции
|
||
<strong>-x</strong>, а позднее повторно определена с
|
||
использованием опции <strong>-relx</strong>, то используется
|
||
только более позднее определение.</p>
|
||
|
||
<pre>
|
||
<strong>place slaves</strong> <em>window</em>
|
||
</pre>
|
||
|
||
<p>Эта команда возвращает список всех виджетов,
|
||
размещенных в мастер-окне. Если в нем не размещены виджеты,
|
||
команда возвращает пустой список.</p>
|
||
|
||
<pre>
|
||
<strong>place forget</strong> <em>window</em>
|
||
</pre>
|
||
|
||
<p>Окно <em>window</em> больше не управляется менеджером
|
||
<strong>place</strong>. Как следствие, оно удаляется с
|
||
экрана. Если окно не управлялось менеджером
|
||
<strong>place</strong>, команда не имеет никакого эффекта.</p>
|
||
|
||
<p>Команда возвращает пустую строку.</p>
|
||
|
||
<pre>
|
||
<strong>place info</strong> <em>window</em>
|
||
</pre>
|
||
|
||
<p>Возвращает список опций и их значений для окна <em>window</em>
|
||
в той же форме, в какой они задаются в команде <strong>place
|
||
configure</strong>. Если конфигурацию виджета, полученную с
|
||
помощью этой команды, предполагается впоследствии восстановить,
|
||
то перед этим необходимо будет использовать команду
|
||
<strong>place forget</strong>, чтобы удалить текущую
|
||
конфигурацию, а затем <strong>place configure</strong> с
|
||
сохраненной конфигурацией.</p>
|
||
|
||
<p>В отличие от многих других геометрических менеджеров
|
||
<strong>place</strong> не пытается манипулировать геометрией
|
||
мастер-окна (например, переустанавливать их размер "по
|
||
потребности"). Чтобы управлять размерами этих окон, для них
|
||
желательно использовать такие виджеты, как <a
|
||
href="frame.html"><strong>frame</strong></a> или <a
|
||
href="canvas.html"><strong>canvas</strong></a>.</p>
|
||
|
||
</body>
|
||
</html>
|