options

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

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

ОПИСАНИЕ

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

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

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

      .a.b.c configure -foreground black
    

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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