249 lines
15 KiB
HTML
249 lines
15 KiB
HTML
<!DOCTYPE HTML PUBLIC -//W3C//DTD HTML 4.01 Transitional//EN>
|
||
<html>
|
||
<head>
|
||
<title>button</title>
|
||
</head>
|
||
<body>
|
||
|
||
<h1>button</h1>
|
||
|
||
<p>Создание примитива кнопки и управление им.</p>
|
||
|
||
<h2><a name=СИНТАКСИС></a>СИНТАКСИС</h2>
|
||
|
||
<pre>
|
||
<strong>button</strong> <em>имяПути параметры</em>
|
||
</pre>
|
||
|
||
<h2><a name=СТАНДАРТНЫЕ_ПАРАМЕТРЫ></a>СТАНДАРТНЫЕ ПАРАМЕТРЫ</h2>
|
||
|
||
<ul>
|
||
<li>-activebackground</li>
|
||
<li>-activeforeground</li>
|
||
<li>-anchor</li>
|
||
<li>-background</li>
|
||
<li>-bitmap</li>
|
||
<li>-borderwidth</li>
|
||
<li>-cursor</li>
|
||
<li>-disabledforeground</li>
|
||
<li>-font</li>
|
||
<li>-highlightbackground</li>
|
||
<li>-highlightcolor</li>
|
||
<li>-highlightthickness</li>
|
||
<li>-image</li>
|
||
<li>-justify</li>
|
||
<li>-padx</li>
|
||
<li>-pady</li>
|
||
<li>-relief</li>
|
||
<li>-takefocus</li>
|
||
<li>-text</li>
|
||
<li>-textvariable</li>
|
||
<li>-underline</li>
|
||
<li>-wraplength</li>
|
||
</ul>
|
||
|
||
<p>Подробное описание этих параметров приведено в разделе
|
||
<a href=options.html><strong>options</strong></a>.</p>
|
||
|
||
<h2><a name=ДОПОЛНИТЕЛЬНЫЕ_ПАРАМЕТРЫ></a>ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ</h2>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-command</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>command</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Command</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Ассоциирует с кнопкой команду Tk. Обычно команда выполняется
|
||
при отпускании клавиши 1 "Мыши".</p>
|
||
|
||
<table>
|
||
<tr><td>Имя параметра:</td><td><strong>-default</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>default</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>Default</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Задает одно из трех состояний изображения ободка кнопки:
|
||
<strong>normal</strong>, <strong>active</strong> или
|
||
<strong>disabled</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>-state</strong></td></tr>
|
||
<tr><td>Имя в Базе:</td><td><strong>state</strong></td></tr>
|
||
<tr><td>Класс в Базе:</td><td><strong>State</strong></td></tr>
|
||
</table>
|
||
|
||
<p>Задает одно из трех состояний кнопки: <strong>normal</strong>,
|
||
<strong>active</strong> или <strong>disabled</strong>. В
|
||
нормальном состоянии кнопка изображается с использованием
|
||
значений параметров <strong>foreground</strong> и
|
||
<strong>background</strong>. В активном состоянии кнопка обычно
|
||
находится, если на ней расположен курсор. Кнопка в активном
|
||
состоянии изображается с использованием значений параметров
|
||
<strong>activeForeground</strong> и
|
||
<strong>activeBackground</strong>. Отключенное состояние
|
||
указывает на то, что кнопка должна быть нечувствительной:
|
||
привязки по умолчанию не приводят к запуску примитива и нажатия
|
||
на кнопку "Мыши" игнорируются. В этом состоянии
|
||
изображение кнопки определяется значениями параметров
|
||
<strong>disabledForeground</strong> и
|
||
<strong>background</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>button</strong> создает новое окно (задаваемое
|
||
аргументом <em>имяПути</em>) и превращает его в примитив кнопки.
|
||
Детали изображения кнопки, такие, как ее цвета, шрифт, текст и
|
||
объемный вид задаются с помощью описанных выше дополнительных
|
||
параметров. Команда <strong>button</strong> возвращает аргумент
|
||
<em>имяПути</em>. В момент выполнения этой команды не должно
|
||
существовать окна с именем <em>имяПути</em>, но должен
|
||
существовать его предок.</p>
|
||
|
||
<p>Кнопка представляет собой примитив, в котором выводится
|
||
текстовая строка, изображение или двуцветное изображение. Весь
|
||
выводимый текст должен быть записан одним шрифтом, однако он
|
||
может занимать несколько строчек на экране (если в нем есть
|
||
символы перевода строки или задан параметр
|
||
<strong>wrapLength</strong>). Один из символов текста может
|
||
быть подчеркнут (в соответствии со значением параметра
|
||
<strong>underline</strong>). В зависимости от значения параметра
|
||
<strong>button</strong> кнопка имеет три разных вида; кнопка
|
||
может выглядеть выпуклой, вдавленной или плоской, кроме того,
|
||
она может мигать. При инициации кнопки (нажатием на клавишу 1
|
||
"Мыши", когда курсор "Мыши" находится на
|
||
кнопке) выполняется команда Tcl, указанная в параметре
|
||
<strong>-command</strong>.</p>
|
||
|
||
<h2><a name=КОМАНДА_ПРИМИТИВА></a>КОМАНДА ПРИМИТИВА</h2>
|
||
|
||
<p>Команда <strong>button</strong> создает новую команду Tcl с
|
||
именем <em>имяПути</em>. С помощью этой команды можно выполнять
|
||
различные операции над примитивом. Ее общий вид.</p>
|
||
|
||
<pre>
|
||
<strong>имяПути</strong> <em>параметр арг арг</em> ...
|
||
</pre>
|
||
|
||
<p><em>Параметр</em> и <em>арг</em>ументы уточняют поведение команды.
|
||
Примитивы кнопки допускают следующие формы команды:</p>
|
||
|
||
<pre>
|
||
<em>имяПути</em> <strong>cget</strong> <em>параметр</em>
|
||
</pre>
|
||
|
||
<p>Возвращает текущее значение параметра конфигурации с именем
|
||
параметр. Параметр может быть любым из параметров команды
|
||
<strong>button</strong>.</p>
|
||
|
||
<pre>
|
||
<em>имяПути</em> <strong>configure</strong> <em>параметр значение параметр значение ...</em>
|
||
</pre>
|
||
|
||
<p>Запрашивает значения параметров конфигурации примитива или
|
||
изменяет их. Если параметр не указан, то возвращает список,
|
||
содержащий значения всех допустимых в <em>имениПути</em>
|
||
параметров (формат списка описан в
|
||
<strong>Tk_ConfigureInfo</strong>). Если <em>параметр</em>
|
||
задан, а его новое значение - нет, то команда возвращает часть
|
||
полного списка, относящуюся к указанному параметру. Если заданы
|
||
одна или несколько пар параметр-значение, то указанным
|
||
параметрам примитива присваиваются новые значения, а команда
|
||
возвращает пустую строку. <em>Параметр</em> может быть любым из
|
||
параметров команды <strong>button</strong>.</p>
|
||
|
||
<pre>
|
||
<em>имяПути</em> <strong>flash</strong>
|
||
</pre>
|
||
|
||
<p>Заставляет кнопку мигать. Этот эффект достигается путем
|
||
многократного вывода изображения кнопки поочередно в активном и
|
||
нормальном состоянии. По окончании работы команды кнопка
|
||
остается в том же состоянии (активном или нормальном), что и
|
||
перед началом ее выполнения. Если перед началом выполнения
|
||
команды кнопка находится в состоянии <strong>disabled</strong>,
|
||
то команда игнорируется.</p>
|
||
|
||
<pre>
|
||
<em>имяПути</em> <strong>invoke</strong>
|
||
</pre>
|
||
|
||
<p>Выполняет команду Tcl, ассоциированную с кнопкой (при наличии
|
||
такой команды). Возвращаемое значение совпадает с возвращаемым
|
||
значением команды Tcl (или является пустой строкой, если с
|
||
кнопкой никакой команды не ассоциировано). Если перед началом
|
||
выполнения команды кнопка находится в состоянии
|
||
<strong>disabled</strong>, то команда игнорируется.</p>
|
||
|
||
<p>При создании кнопки Tk, в соответствии с типом кнопки,
|
||
автоматически создает привязки к ней, определяющие ее поведение
|
||
по умолчанию:</p>
|
||
|
||
<p>Кнопка становится активной при появлении над ней курсора
|
||
"Мыши" и дезактивируется, когда курсор ее покидает. В
|
||
системе Windows привязка активизируется только при нажатии
|
||
клавиши "1" "Мыши" на кнопке.</p>
|
||
|
||
<p>При нажатии клавиши "1" "Мыши" на кнопке
|
||
кнопка "вдавливается", а при отпускании клавиши она
|
||
восстанавливает свой первоначальный вид.</p>
|
||
|
||
<p>Если на кнопке клавиша "1" "Мыши" была
|
||
нажата, а затем отпущена, то выполняется команда, привязанная к
|
||
данной кнопке. Этого, однако, не происходит, если в момент
|
||
отпускания клавиши "Мыши" курсор "Мыши"
|
||
находился вне поля кнопки.</p>
|
||
|
||
<p>Если кнопка находится в фокусе ввода, то нажатие на клавишу
|
||
пробела приводит к выполнению команды, привязанной к этой
|
||
кнопке.</p>
|
||
|
||
<p>Если кнопка находится в состоянии <strong>disabled</strong>, то
|
||
все описанные выше действия не приводят ни к какому результату:
|
||
кнопка остается неактивной.</p>
|
||
|
||
<p>Поведение кнопки можно изменить с помощью новых привязок к
|
||
конкретным примитивам или путем переопределения привязок данного
|
||
класса.</p>
|
||
|
||
</body>
|
||
</html>
|
||
|
||
|
||
|