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>place</title>
|
|
|
|
|
|
</head>
|
|
|
|
|
|
<body>
|
|
|
|
|
|
|
|
|
|
|
|
<h1>place</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>
|
|
|
|
|
|
<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>
|
|
|
|
|
|
|
|
|
|
|
|
|
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>place</strong> позволяет
|
|
|
|
|
|
размещать виджеты в их мастер-окнах, используя прямые указания о
|
|
|
|
|
|
размерах и размещении виджета. Кроме того, с его помощью можно
|
|
|
|
|
|
добиваться режима "резинового листа", указывая размеры и
|
|
|
|
|
|
размещение виджета в долях размера мастер-окна. При этом виджеты
|
|
|
|
|
|
изменяют свои размеры при изменении размеров мастер окна. И,
|
|
|
|
|
|
наконец, менеджер place позволяет сочетать оба этих метода,
|
|
|
|
|
|
размещая, например, виджет определенного размера в центре
|
|
|
|
|
|
мастер-окна.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Команда <strong>place</strong> используется для управления
|
|
|
|
|
|
соответствующим геометрическим менеджером и для получения от
|
|
|
|
|
|
него справочной информации. Команда может иметь перечисленные
|
|
|
|
|
|
ниже формы.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dl>
|
|
|
|
|
|
<dt><strong>place</strong> <em>window option value</em>
|
|
|
|
|
|
?<em>option value ...</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd>Если первый аргумент команды является именем окна (любая
|
|
|
|
|
|
величина, начинающаяся с "."), команда выполняется
|
|
|
|
|
|
точно так же, как команда <strong>place
|
2015-10-19 13:27:31 +03:00
|
|
|
|
configure</strong>.</dd>
|
|
|
|
|
|
|
|
|
|
|
|
<dt><strong>place configure</strong> <em>window option
|
|
|
|
|
|
value</em> ?<em>option value ...</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd><p>Аргумент команды состоит из имени размещаемого виджета,
|
|
|
|
|
|
после которого идут пары аргументов, состоящих из имени
|
|
|
|
|
|
опции и ее значения. Если виджет уже обрабатывался с помощью
|
|
|
|
|
|
команды <strong>place</strong>, то для не определенных в
|
|
|
|
|
|
команде опций будут использоваться старые значения, а не
|
|
|
|
|
|
значения по умолчанию. Команда возвращает пустую строку</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>
|
|
|
|
|
|
<dt><strong>-in</strong> <em>master</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd>Аргумент <em>master</em> определяет полное имя виджета
|
|
|
|
|
|
(мастер-окна), относительно которого будет размещаться
|
|
|
|
|
|
виджет window. Мастер-окно должно быть непосредственным
|
|
|
|
|
|
предком виджета, или потомком этого предка. При этом они
|
|
|
|
|
|
оба должны быть потомками одного и того же
|
|
|
|
|
|
toplevel-окна. Эти ограничения необходимы, чтобы
|
|
|
|
|
|
гарантировать, что виджет будет виден, когда видно
|
|
|
|
|
|
мастер-окно. По умолчанию виджет размещается в своем
|
|
|
|
|
|
непосредственном предке.</dd>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dt><strong>-x</strong> <em>location</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd><p>Аргумент <em>location</em> определяет
|
|
|
|
|
|
<em>x</em>-координату в мастер-окне для якорной точки
|
|
|
|
|
|
виджета. Координата указывается на экране в одной из
|
|
|
|
|
|
следующих форм:</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<ul>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в пикселях (число),</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в сантиметрах (число с буквой <strong>c</strong> на
|
|
|
|
|
|
конце),</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в миллиметрах (число с буквой <strong>m</strong> на
|
|
|
|
|
|
конце),</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в дюймах (число с буквой <strong>i</strong> на
|
|
|
|
|
|
конце)</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в точках (число с буквой <strong>p</strong>на конце,
|
|
|
|
|
|
точка равна 1/72 дюйма).</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</ul>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Якорная точка не обязана находиться внутри мастер-окна.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</dd>
|
|
|
|
|
|
|
|
|
|
|
|
<dt><strong>-relx</strong> <em>location</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dt><strong>-y</strong> <em>location</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd><p>Аргумент <em>location</em> определяет y-координату в
|
|
|
|
|
|
мастер-окне для якорной точки виджета. Координата
|
|
|
|
|
|
указывается на экране в одной из следующих форм:</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<ul>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в пикселях (число),</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в сантиметрах (число с буквой <strong>c</strong> на
|
|
|
|
|
|
конце),</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в миллиметрах (число с буквой <strong>m</strong> на
|
|
|
|
|
|
конце),</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в дюймах (число с буквой <strong>i</strong> на
|
|
|
|
|
|
конце),</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<li>в точках (число с буквой <strong>i</strong> на
|
|
|
|
|
|
конце, точка равна 1/72 дюйма).</li>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</ul>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Якорная точка не обязана находиться
|
|
|
|
|
|
внутри мастер-окна.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</dd>
|
|
|
|
|
|
|
|
|
|
|
|
<dt><strong>-rely</strong> <em>location</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dt><strong>-anchor</strong> <em>where</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd>Аргумент <em>where</em> определяет, какая точка виджета
|
|
|
|
|
|
будет помещена в якорной точке, заданной с помощью опций
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<strong>-x</strong>, <strong>-y</strong>,
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<strong>-relx</strong> и <strong>-rely</strong>. В якорную
|
|
|
|
|
|
точку помещается крайняя точка виджета (включая границу,
|
|
|
|
|
|
если она задана). Так значение <strong>se</strong>
|
|
|
|
|
|
означает, что в якорную точку будет помещен нижний правый
|
|
|
|
|
|
угол виджета. Значение по умолчанию
|
2015-10-19 13:27:31 +03:00
|
|
|
|
<strong>nw</strong>.</dd>
|
|
|
|
|
|
|
|
|
|
|
|
<dt><strong>-width</strong> <em>size</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd>Аргумент <em>size</em> определяет ширину виджета на
|
|
|
|
|
|
экране (допустимы те же формы, что и для опций
|
|
|
|
|
|
<strong>-x</strong>и <strong>-y</strong>). Ширина это
|
|
|
|
|
|
внешняя ширина виджета, включая его границу (если она
|
|
|
|
|
|
задана). Если аргумент представляет собой пустую строку
|
|
|
|
|
|
или если ни опция <strong>-width</strong>, ни опция
|
|
|
|
|
|
<strong>-relwidth</strong> не определены, ширина виджета
|
|
|
|
|
|
определяется исходя из его собственных запросов.</dd>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dt><strong>-relwidth</strong> <em>size</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd>Аргумент <em>size</em> определяет ширину виджета на
|
|
|
|
|
|
экране. Ширина указывается в виде десятичного числа в
|
|
|
|
|
|
долях соответствующего размера мастер-окна. Так 0.5
|
|
|
|
|
|
соответствует ширине в половину ширины мастер-окна. Если
|
|
|
|
|
|
указаны обе опции, <strong>-width</strong> и
|
|
|
|
|
|
<strong>-relwidth</strong>, то соответствующие величины
|
|
|
|
|
|
складываются. Например, <strong>-relwidth 1.0 -width
|
|
|
|
|
|
5</strong> делает виджет на 5 пикселей шире
|
|
|
|
|
|
мастер-окна.</dd>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dt><strong>-height</strong> <em>size</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd>Аргумент <em>size</em> определяет высоту виджета на
|
|
|
|
|
|
экране (допустимы те же формы, что и для опций
|
|
|
|
|
|
<strong>-x</strong>и <strong>-y</strong>). Высота это
|
|
|
|
|
|
внешняя высота виджета, включая его границу (если она
|
|
|
|
|
|
задана). Если аргумент представляет собой пустую строку
|
|
|
|
|
|
или если ни опция <strong>-height</strong>, ни опция
|
|
|
|
|
|
<strong>-relheight</strong> не определены, высота виджета
|
|
|
|
|
|
определяется исходя из его собственных запросов.</dd>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dt><strong>-relheight</strong> <em>size</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<dd>Аргумент <em>size</em> определяет высоту виджета на
|
|
|
|
|
|
экране. Высота указывается в виде десятичного числа в
|
|
|
|
|
|
долях соответствующего размера мастер-окна. Так
|
|
|
|
|
|
"0.5" соответствует высоте в половину высоты
|
|
|
|
|
|
мастер-окна. Если указаны обе опции,
|
|
|
|
|
|
<strong>-height</strong> и <strong>-relheight</strong>, то
|
|
|
|
|
|
соответствующие величины складываются. Например,
|
|
|
|
|
|
<strong>-relheight 1.0 -height -2</strong> делает виджет
|
|
|
|
|
|
на 2 пикселя ниже мастер-окна.</dd>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<dt><strong>-bordermode</strong> <em>mode</em></dt>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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
|
2015-10-19 13:27:31 +03:00
|
|
|
|
-anchor ne</strong>.</p>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Значение <strong>ignore</strong> означает, что менеджер
|
|
|
|
|
|
включает в состав окна все внутренние границы, но не
|
|
|
|
|
|
внешние границы (его официальное X-определение). Это
|
|
|
|
|
|
значение используется, вероятно, реже остальных.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
</dd>
|
|
|
|
|
|
</dl>
|
|
|
|
|
|
</dd>
|
|
|
|
|
|
</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>Если значение одной и той же величины определено дважды с
|
|
|
|
|
|
использованием различных опций, например, если x-координата
|
|
|
|
|
|
виджета определена сначала с использованием опции
|
|
|
|
|
|
<strong>-x</strong>, а позднее повторно определена с
|
|
|
|
|
|
использованием опции <strong>-relx</strong>, то используется
|
|
|
|
|
|
только более позднее определение.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<strong>place slaves</strong> <em>window</em>
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Эта команда возвращает список всех виджетов,
|
|
|
|
|
|
размещенных в мастер-окне. Если в нем не размещены виджеты,
|
|
|
|
|
|
команда возвращает пустой список.</p>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<strong>place forget</strong> <em>window</em>
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<p>Окно <em>window</em> больше не управляется менеджером
|
|
|
|
|
|
<strong>place</strong>. Как следствие, оно удаляется с
|
|
|
|
|
|
экрана. Если окно не управлялось менеджером
|
|
|
|
|
|
<strong>place</strong>, команда не имеет никакого эффекта.</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
|
|
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
|
|
<strong>place info</strong> <em>window</em>
|
|
|
|
|
|
</pre>
|
|
|
|
|
|
|
2018-02-05 17:22:04 +03:00
|
|
|
|
<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>
|
2015-10-19 13:27:31 +03:00
|
|
|
|
|
|
|
|
|
|
</body>
|
|
|
|
|
|
</html>
|
2018-02-05 17:22:04 +03:00
|
|
|
|
|
