Здесь приводится описание всех стандартных параметров примитивов. Не все параметры используются примитивами, но если примитив использует некоторый параметр, то действие этого параметра будет именно таким, как оно описано.
В этом разделе руководства описываются общие параметры конфигурации, поддерживаемые примитивами (виджетами) языка 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
в любом виде, приемлемом для Tk GetBitMap для
отображения в примитиве. Другие параметры, вроде anchor и justify,
уточняют способ отображения информации типа bitmap.
Обычно при задании этого параметра значения остальных параметров, задающих
способ отображения текстовой информации, игнорируются. Для восстановления
возможности вывода текстовой информации в примитиве следует задать значение
параметра bitmap в виде пустой строки. Задание параметра imageподавляет
параметр bitmap в примитивах, использующих
оба эти параметра.
Задает неотрицательное значение
ширины трехмерного бордюра, окружающего изображение примитива (при выводе
такого бордюра; необходимость его вывода обычно указывается параметром
relief).
То же значение может быть использовано при имитации трехмерной графики
внутри примитива. Значение параметра может быть любым из тех, что приемлемы
для Tk GetPixels.
Задает форму курсора "Мыши" на
примитиве. Значение параметра должно быть одним из значений, которые перечислены
в файле /usr/X11R6/unclude/X11/cursorfont.h, например, X_cursor ,
arrow, boat, clock, cross , то есть можно указывать
любое значение их данного файла, в котором нужно опустить первые три символа
"XC_ ".
Задает шрифт для отображения текста
внутри примитива. Синтаксис имени шрифта описан в команде font.
Спаисок доступных шрифтов можно получить команой xlsfonts.
Задает нормальный цвет переднего
плана примитива.
Задает цвет яркого прямоугольника
обрамляющего примитив, находящийся вне фокуса ввода.
Задает неотрицательное значение
ширины яркого прямоугольника вокруг примитива, находящегося в фокусе ввода.
Значение параметра должно быть допустимым аргументом функции Tk GetPixels.
При значении, равном нулю, яркая рамочка вокруг примитива не выводится.
Задает цвет фона поля, на котором
установлен курсор ввода. Этот параметр подавляет цвет нормального фона
примитива (или фона выбранного элемента, если курсор ввода оказался на
выбранном элементе).
Задает неотрицательное значение
ширины трехмерного бордюра вокруг курсора ввода. Значение параметра должно
быть допустимым аргументом функции Tk GetPixels .
Задает полную ширину курсора ввода.
Значение параметра должно быть допустимым аргументом функции 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:
при установлении режима автоматического повторения этот параметр задает
длину промежутка времени между автоматическими повторениями.
Задает цвет фона при отображении
выбранных элементов.
Задает цвет переднего плана для
изображения выбранных элементов.
Указывает, допустима ли установка
фокуса на окне с помощью клавиатуры (клавишами Tab и Shift-Tab).
Перед установкой фокуса на окне скрипты перевода фокуса проверяют значение
параметра takeFocus. Значение '0' указывает на необходимость пропускать
окно при клавиатурном переключении фокуса. Значение ` 1'
указывает на то, что при видимом окне (и всех его наследниках) фокус должен
устанавливаться на нем. Пустое значение указывает на то, что скрипт переключения
сам принимает решение, следует ли устанавливать фокус на данном окне: в
текущем варианте окно пропускается, если оно отключено или в нем нет ключевых
связок, или оно невидимо. При любом другом значении параметра скрипт переключения
добавляет к этому значению имя окна (через разделяющий пробел) и интерпретирует
получившуюся строку как скрипт Tcl. Скрипт должен возвращать значение ` 0 ' ,`1'
или пустую строку. Значения '0' и ` 1 ' указывают, должен ли фокус ввода установиться на окно, пустая строка вызывает
обработку по умолчанию, описанную выше. Замечание: подобная обработка параметра
целиком определяется скриптами переключения Tcl; реализация примитивов
полностью игнорирует рассматриваемый параметр.
Имя параметра: -text
Имя в Базе: text
Класс в Базе: Text
Задает строку, выводимую в примитиве.
Способ вывода строки зависит от конкретного примитива и определяется значениями
других параметров, таких как anchor или justify .
Имя в Базе: textVariable
Класс в Базе: Variable
Задает имя переменной. Значением
переменной является текстовая строка, которая должна быть выведена в примитиве.
При изменении значения переменной выведенная строка тут же изменяется.
Способ вывода строки зависит от конкретного примитива и определяется значениями
других параметров, таких как anchor или
justify .
Имя в Базе: troughColor
Класс в Базе: Background
Имя в Базе: underline
Класс в Базе: Underline
Задает номер подчеркиваемого символа
в примитиве. Этот параметр используется связками по умолчанию для клавиатурного
переключения кнопок меню и полей меню. '0' соответствует первому символу,
` 1 ' - второму, и т.д.
Имя в Базе: wrapLength
Класс в Базе: WrapLength
Для примитивов, способных выполнять
перенос строк этот параметр задает максимальную длину строки. Строки, длина
которых превосходит установленную, переносятся на следующую строку. Это
значение может быть задано в любом виде, в котором могут задаваться экранные
расстояния. Если это значение неположительно, то переноса не происходит:
он выполняется только при появлении символа переноса строки.
Имя в Базе: xScrollCommand
Класс в Базе: ScrollCommand
Имя в Базе: yScrollCommand
Класс в Базе: ScrollCommand
Задает префикс команды, используемой
для связи с вертикальной полосой прокрутки. Этот параметр интерпретируется
так
же, как и параметр xScrollCommand, за исключением того, что он относится
к вертикальной полосе прокрутки и используется в примитивах, которые такую
полосу поддерживают. Подробное описание см. выше.