# options

Приведено описание стандартных параметров примитивов.

Здесь приводится описание всех стандартных параметров примитивов. Не все параметры используются примитивами, но если примитив использует некоторый параметр, то действие этого параметра будет именно таким, как оно описано.

## ОПИСАНИЕ

options стандартные параметры, поддерживаемые примитивами.

В этом разделе руководства описываются общие параметры конфигурации, поддерживаемые примитивами (виджетами) языка Tk. Не каждый примитив поддерживает все параметры (список стандартных параметров примитива приведен в описании этого примитива), однако если примитив поддерживает параметр, имя которого приведено в нижеследующем списке, то результат его указания совпадает с описанным ниже.

В приводимом ниже описании строка .Имя Параметра. указывает имя переключателя в командах класса и командах примитивов configure, предназначенных для установки значения параметра. Если, например, в строке. Имя параметра. указано имя -foreground и имеется примитив .a.b.c, то с помощью команды

          .a.b.c configure -foreground black

можно присвоить значение black параметру -foreground примитива .a.b.c. Для имен параметров можно использовать сокращения, сохраняющие однозначность интерпретации имени. В поле "Имя в Базе" приводится имя параметра в базе X-ресурсов (например, в файле .Xdefaults). В поле "Класс в Базе" приводится имя класса базы в файле X-ресурсов (например, в файле .Xdefaults).

Имя параметра: | -activebackground
Имя в Базе: | activeBackground
Класс в Базе: | Foreground

Задает цвет фона при изображении активных элементов. Элемент (примитив или его часть) активен, если на нем находится курсор "Мыши" и нажатие на клавишу "Мыши" вызывает некоторое действие. Если установлено значение переменной tk_strictMotif, то значение указанного параметра игнорируется и используется обычный цвет фона. Для некоторых элементов в системах Windows и Macintosh установленный цвет активизируется только при щелчке клавиши 1 на элементе.

Имя параметра: | -activedorderwidth
Имя в Базе: | activeBorderWidth
Класс в Базе: | BorderWidth

Задает неотрицательное значение ширины трехмерного бордюра, окружающего активные элементы. Определение активных элементов приведено выше. Значение может быть задано в любом виде,воспринимаемом командой Tk GetPixels. Обычно этот параметр доступен только для примитивов, отображающих более одного элемента одновременно (меню, а не кнопки).

Имя параметра: | -activeforeground
Имя в Базе: | activeForeground
Класс в Базе: | Background

Задает цвет изображения активного элемента. Определение активных элементов приведено выше.

Имя параметра: | -anchor
Имя в Базе: | anchor
Класс в Базе: | Anchor

Задает способ отображения информации (типа текст или bitmap) в примитиве. Должен принимать одно из значений n, ne, e, se, s, sw, w, nw или center, которые указывают на стороны света. Например, значение nw указывает на необходимость такого отображения информации, что ее левый верхний угол совпадает с левым верхним уровнем примитива.

Имя параметра: | -background or -bg
Имя в Базе: | background
Класс в Базе: | Background

Задает нормальный цвет фона при отображении примитива.

Имя параметра: | -bitmap
Имя в Базе: | bitmap
Класс в Базе: | Bitmap

Задает информацию типа bitmap в любом виде, приемлемом для TkGetBitMap для отображения в примитиве. Другие параметры, вроде anchor и justify, уточняют способ отображения информации типа bitmap. Обычно при задании этого параметра значения остальных параметров, задающих способ отображения текстовой информации, игнорируются. Для восстановления возможности вывода текстовой информации в примитиве следует задать значение параметра bitmap в виде пустой строки. Задание параметра image подавляет параметр bitmap в примитивах, использующих оба эти параметра.

Имя параметра: | -borderwidth or -bd
Имя в Базе: | borderWidth
Класс в Базе: | BorderWidth

Задает неотрицательное значение ширины трехмерного бордюра, окружающего изображение примитива (при выводе такого бордюра; необходимость его вывода обычно указывается параметром relief). То же значение может быть использовано при имитации трехмерной графики внутри примитива. Значение параметра может быть любым из тех, что приемлемы для TkGetPixels.

Имя параметра: | -cursor
Имя в Базе: | cursor
Класс в Базе: | Cursor

Задает форму курсора .Мыши. на примитиве. Значение параметра должно быть одним из значений, которые перечислены в файле /usr/X11R6/unclude/X11/cursorfont.h, например, X_cursor, arrow, boat, clock, cross, то есть можно указывать любое значение их данного файла, в котором нужно опустить первые три символа XC_.

Имя параметра: | -disabledforeground
Имя в Базе: | disabledForeground
Класс в Базе: | DisabledForeground

Задает цвет переднего плана для изображения недоступного элемента. При вводе пустой строки (типичная ситуация для монохромного дисплея) недоступные элементы изображаются обычным цветом, однако их изображение делается более тусклым за счет штриховки.

Имя параметра: | -exportselection
Имя в Базе: | exportSelection
Класс в Базе: | ExportSelection

Указывает, должен ли выбранный элемент в примитиве входить также и в X-выборку. Значение параметра должно быть допустимым аргументом функции TclGetBoolean, скажем true, false, 0, 1, yes или no. При экспорте выбранного элемента выборка в примитиве отменяет текущую X-выборку; выборка за пределами примитива отменяет текущую выборку в примитиве. При наличии в примитиве выбранного элемента примитив отзывается на запросы поиска выбранных элементов. По умолчанию примитивы обычно экспортируют выбранные элементы.

Имя параметра: | -font
Имя в Базе: | font
Класс в Базе: | Font

Задает шрифт для отображения текста внутри примитива. Синтаксис имени шрифта описан в команде font. Список доступных шрифтов можно получить командой xlsfonts.

Имя параметра: | -fg
Имя в Базе: | foreground
Класс в Базе: | Foreground

Задает нормальный цвет переднего плана примитива.

Имя параметра: | -highlightbackground
Имя в Базе: | highlightBackground
Класс в Базе: | HighlightBackground

Задает цвет яркого прямоугольника обрамляющего примитив, находящийся вне фокуса ввода.

Имя параметра: | -highlightcolor
Имя в Базе: | highlightColor
Класс в Базе: | HighlightColor

Задает цвет яркого прямоугольника обрамляющего примитив, находящийся в фокусе ввода.

Имя параметра: | -highlightthickness
Имя в Базе: | highlightThickness
Класс в Базе: | HighlightThickness

Задает неотрицательное значение ширины яркого прямоугольника вокруг примитива, находящегося в фокусе ввода. Значение параметра должно быть допустимым аргументом функции Tk_GetPixels. При значении, равном нулю, яркая рамочка вокруг примитива не выводится.

Имя параметра: | -image
Имя в Базе: | image
Класс в Базе: | Image

Задает изображение, которое должно быть выведено в примитиве, созданном командой image create. Обычно при задании параметра image значения других параметров, задающих текстовые или bitmap данные для вывода в примитиве, подавляются. Для восстановления возможности вывода текстовых или bitmap данных следует задать пустое значение параметра image.

Имя параметра: | -insertbackground
Имя в Базе: | insertBackground
Класс в Базе: | Foreground

Задает цвет фона поля, на котором установлен курсор ввода. Этот параметр подавляет цвет нормального фона примитива (или фона выбранного элемента, если курсор ввода оказался на выбранном элементе).

Имя параметра: | -insertborderwidth
Имя в Базе: | insertBorderWidth
Класс в Базе: | BorderWidth

Задает неотрицательное значение ширины трехмерного бордюра вокруг курсора ввода. Значение параметра должно быть допустимым аргументом функции Tk_GetPixels.

Имя параметра: | -insertofftime
Имя в Базе: | insertOffTime
Класс в Базе: | OffTime

Задает длину промежутка времени, в течение которого курсор ввода находится в режиме "off" (неотрицательное целое значение в миллисекундах) на протяжении одного цикла мигания. Если введенное значение равно нулю, то курсор не мигает: он всегда находится в режиме "on".

Имя параметра: | -inserontime
Имя в Базе: | insertOnTime
Класс в Базе: | OnTime

Задает длину промежутка времени, в течение которого курсор ввода находится в режиме "on" (неотрицательное целое значение в миллисекундах) на протяжении одного цикла мигания.

Имя параметра: | -insertwidth
Имя в Базе: | insertWidth
Класс в Базе: | InsertWidth

Задает полную ширину курсора ввода. Значение параметра должно быть допустимым аргументом функции Tk_GetPixels. Если (с помощью параметра insertBorderWidth) задана ширина бордюра, то бордюр будет располагаться внутри отведенной ширины курсора.

Имя параметра: | -jump
Имя в Базе: | jump
Класс в Базе: | Jump

Задает тип изменения значения примитива для примитивов, поддерживающих полосу прокрутки. Значение параметра должно быть допустимым булевским аргументом функции Tk_GetBoolean. При значении параметра false значения примитива изменяются непрерывно. При значении параметра true значение примитива не меняется до окончания движения бегунка и отпускания клавиши "Мыши". В этот момент происходит установка нового значения ("скачок", в отличие от непрерывного изменения).

Имя параметра: | -justify
Имя в Базе: | justify
Класс в Базе: | Justify

Описывает способ выравнивания текста, состоящего из нескольких строк, в окне примитива. Может принимать значения left, center или right. Leftозначает, что выравниваются левые концы строк, center их середины, right правые концы.

Имя параметра: | -orient
Имя в Базе: | orient
Класс в Базе: | Orient

Указывает ориентацию примитива, допускающего различные ориентации (так, полоса прокрутки может быть расположена горизонтально или вертикально). Может принимать значения horizontal или vertical, а также их сокращения.

Имя параметра: | padx
Имя в Базе: | padX
Класс в Базе: | Pad

Неотрицательное значение, указывающее размер запрашиваемого дополнительного пространства для примитива в X-направлении. Значение параметра должно быть допустимым аргументом функции Tk_GetPixels. При подсчете необходимого размера окна эта величина добавляется к обычному размеру, определяемому суммированием всех размеров всех его деталей. Если программа вывода в состоянии удовлетворить выданный запрос, то в правой и/или левой части окна примитива появляется дополнительное пространство. В большинстве случаев это пространство используется только для расположения там текста; при выводе bitmap-данных или изображений оно игнорируется.

Имя параметра: | -pady
Имя в Базе: | padY
Класс в Базе: | Pad

Неотрицательное значение, указывающее размер запрашиваемого дополнительного пространства для примитива в Y-направлении. Значение параметра должно быть допустимым аргументом функции Tk_GetPixels. При подсчете необходимого размера окна эта величина добавляется к обычному размеру, определяемому суммированием всех размеров всех его деталей. Если программа вывода в состоянии удовлетворить выданный запрос, то в правой и/или левой части окна примитива появляется дополнительное пространство. В большинстве случаев это пространство используется только для расположения там текста; при выводе bitmap-данных или изображений оно игнорируется.

Имя параметра: | -relief
Имя в Базе: | relief
Класс в Базе: | Relief

Задает тип трехмерной графики в примитиве. Допустимы значения raised, sunken, flat, ridge, solid или groove. Значение указывает на способ размещения внутренней части окна по отношению к фону. Например, значение raised указывает, что внутренняя часть окна должна выступать из экрана.

Имя параметра: | -repeatdelay
Имя в Базе: | repeatDelay
Класс в Базе: | RepeatDelay

Указывает продолжительность нажатия на кнопку или клавишу (в миллисекундах), необходимую для установления режима автоматического повторения. Используется, например, при работе со стрелками полосы прокрутки.

Имя параметра: | -repeatinterval
Имя в Базе: | repeatInterval
Класс в Базе: | RepeatInterval

Используется в паре с repeatDelay: при установлении режима автоматического повторения этот параметр задает длину промежутка времени между автоматическими повторениями.

Имя параметра: | -selectbackground
Имя в Базе: | selectBackground
Класс в Базе: | Foreground

Задает цвет фона при отображении выбранных элементов.

Имя параметра: | -selectborderwidth
Имя в Базе: | selectBorderWidth
Класс в Базе: | BorderWidth

Задает ширину трехмерного бордюра вокруг выбранных элементов. Допустимы любые значения, воспринимаемые командой Tk_GetPixels.

Имя параметра: | -selectforeground
Имя в Базе: | selectForeground
Класс в Базе: | Background

Задает цвет переднего плана для изображения выбранных элементов.

Имя параметра: | -setgrid
Имя в Базе: | setGrid
Класс в Базе: | SetGrid

Задает булевское значение, определяющее, управляет ли данный примитив масштабирующей сеткой своего окна верхнего уровня. Обычно этот параметр используется в текстовых примитивах с естественным размером отображаемой информации (размером символа) и размеры окна осмысленно выбирать пропорциональными этому стандартному размеру. Эти разумные размеры окон образуют сетку. Если задано значение true параметра setGrid, то примитив установит связь с менеджером окон. В этом случае при интерактивном запросе пользователя на изменение размеров окна верхнего уровня, содержащего примитив, возможный список размеров окна будет передан пользователю в единицах сетки, и значения его длины и ширины должны быть пропорциональны сторонам ячейки сетки. Более подробно этот процесс описан ниже (см. "УПРАВЛЕНИЕ ГЕОМЕТРИЕЙ СЕТОК" в описании команды wm).

Имя параметра: | -takefocus
Имя в Базе: | takeFocus
Класс в Базе: | TakeFocus

Указывает, допустима ли установка фокуса на окне с помощью клавиатуры (клавишами Tab и Shift-Tab). Перед установкой фокуса на окне скрипты перевода фокуса проверяют значение параметра takeFocus. Значение "0" указывает на необходимость пропускать окно при клавиатурном переключении фокуса. Значение "1" указывает на то, что при видимом окне (и всех его наследниках) фокус должен устанавливаться на нем. Пустое значение указывает на то, что скрипт переключения сам принимает решение, следует ли устанавливать фокус на данном окне: в текущем варианте окно пропускается, если оно отключено или в нем нет ключевых связок, или оно невидимо. При любом другом значении параметра скрипт переключения добавляет к этому значению имя окна (через разделяющий пробел) и интерпретирует получившуюся строку как скрипт Tcl. Скрипт должен возвращать значение "0", "1" или пустую строку. Значения "0" и "1" указывают, должен ли фокус ввода установиться на окно, пустая строка вызывает обработку по умолчанию, описанную выше. Замечание: подобная обработка параметра целиком определяется скриптами переключения Tcl; реализация примитивов полностью игнорирует рассматриваемый параметр.

Имя параметра: | -text
Имя в Базе: | text
Класс в Базе: | Text

Задает строку, выводимую в примитиве. Способ вывода строки зависит от конкретного примитива и определяется значениями других параметров, таких как anchor или justify.

Имя параметра: | -textvariable
Имя в Базе: | textVariable
Класс в Базе: | Variable

Задает имя переменной. Значением переменной является текстовая строка, которая должна быть выведена в примитиве. При изменении значения переменной выведенная строка тут же изменяется. Способ вывода строки зависит от конкретного примитива и определяется значениями других параметров, таких как anchor или justify.

Имя параметра: | -troughcolor
Имя в Базе: | troughColor
Класс в Базе: | Background

Задает цвет обрамляющих прямоугольников полосы прокрутки, поля масштабов и т.д. в примитиве

Имя параметра: | -underline
Имя в Базе: | underline
Класс в Базе: | Underline

Задает номер подчеркиваемого символа в примитиве. Этот параметр используется связками по умолчанию для клавиатурного переключения кнопок меню и полей меню. "0" соответствует первому символу, "1" второму, и т.д.

Имя параметра: | -wraplength
Имя в Базе: | wrapLength
Класс в Базе: | WrapLength

Для примитивов, способных выполнять перенос строк этот параметр задает максимальную длину строки. Строки, длина которых превосходит установленную, переносятся на следующую строку. Это значение может быть задано в любом виде, в котором могут задаваться экранные расстояния. Если это значение неположительно, то переноса не происходит: он выполняется только при появлении символа переноса строки.

Имя параметра: | -xscrollcommand
Имя в Базе: | xScrollCommand
Класс в Базе: | ScrollCommand

Задает префикс команды, используемой для связи с горизонтальной полосой прокрутки. При изменении содержимого окна примитива (или любом другом событии, которое может повлечь за собой изменение вида полосы прокрутки, скажем изменении размера содержимого примитива) примитив генерирует команду Tcl путем конкатенации значения параметра и двух чисел, каждое из которых представляет собой дробь между нулем и единицей. Числа указывают положение текста в документе. "0" указывает на начало документа, "1" на его конец, ".333" на одну треть от начала документа и т.д. Первое число обозначает начало видимой части документа, второе на позицию, непосредственно следующую за концом видимой части. Затем команда передается интерпретатору Tcl для выполнения. Обычно значение параметра xScrollCommand состоит из имени пути к примитиву полосы прокрутки, за которым следует слово "set", например, .x.scrollbar set: в результате состояние полосы будет изменяться всякий раз при изменении содержимого окна. Если параметр не задан, то никакая команда не будет исполняться.

Имя параметра: | -yscrollcommand
Имя в Базе: | yScrollCommand
Класс в Базе: | ScrollCommand

Задает префикс команды, используемой для связи с вертикальной полосой прокрутки. Этот параметр интерпретируется так же, как и параметр xScrollCommand, за исключением того, что он относится к вертикальной полосе прокрутки и используется в примитивах, которые такую полосу поддерживают. Подробное описание см. выше.