projman/hlp/ru/tk/place.html
2015-10-19 14:27:31 +04:00

296 lines
11 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!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> позволяет
размещать виджеты в их мастер-окнах, используя прямые указания о
размерах и размещении виджета. Кроме того, с его помощью можно
добиваться режима &quot;резинового листа&quot;, указывая размеры и
размещение виджета в долях размера мастер-окна. При этом виджеты
изменяют свои размеры при изменении размеров мастер окна. И,
наконец, менеджер place позволяет сочетать оба этих метода,
размещая, например, виджет определенного размера в центре
мастер-окна.</p>
<p>Команда <strong>place</strong> используется для управления
соответствующим геометрическим менеджером и для получения от
него справочной информации. Команда может иметь перечисленные
ниже формы.</p>
<dl>
<dt><strong>place</strong> <em>window option value</em>
?<em>option value ...</em></dt>
<dd>Если первый аргумент команды является именем окна (любая
величина, начинающаяся с &quot;.&quot;), команда выполняется
точно так же, как команда <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>-координату в мастер окне для якорной точки
виджета. Координата указывается на экране в виде
десятичного числа в долях соответствующего размера
мастер-окна. Так &quot;0.0&quot; соответствует левому краю
мастер окна, &quot;1.0&quot; правому краю. Если указаны
обе опции, <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>-координату в мастер-окне для якорной точки
виджета. Координата указывается на экране в виде
десятичного числа в долях соответствующего размера
мастер-окна. Так &quot;0.0&quot; соответствует верхнему
краю мастер-окна, &quot;1.0&quot; нижнему краю. Если
указаны обе опции, <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> определяет высоту виджета на
экране. Высота указывается в виде десятичного числа в
долях соответствующего размера мастер-окна. Так
&quot;0.5&quot; соответствует высоте в половину высоты
мастер-окна. Если указаны обе опции,
<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> не пытается манипулировать геометрией
мастер-окна (например, переустанавливать их размер &quot;по
потребности&quot;). Чтобы управлять размерами этих окон, для них
желательно использовать такие виджеты, как <a
href="frame.html"><strong>frame</strong></a> или <a
href="canvas.html"><strong>canvas</strong></a>.</p>
</body>
</html>