options

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

В описаниях ниже, «Имя в командной строке» относится к переключателю, используемому в командах класса и командах виджета configure для задания этого значения. Например, если переключатель опции в командной строке — -foreground, и существует виджет .a.b.c, то команду

.a.b.c  configure  -foreground black

можно использовать для задания значения черный для опции в виджете .a.b.c. Переключатели командной строки могут быть сокращены, если сокращение однозначно. «Имя в базе данных» относится к имени опции в базе данных опций (например, в файлах .Xdefaults). «Класс в базе данных» относится к классу значения опции в базе данных опций.

Имя в командной строке: -activebackground
Имя в базе данных: activeBackground
Класс в базе данных: Foreground: Устанавливает цвет фона, используемый при отображении активных элементов. Элемент (виджет или часть виджета) считается активным, если курсор мыши расположен над ним, и нажатие кнопки мыши вызовет какое-либо действие. Если был запрошен строгий стандарт Motif, установив переменную tk_strictMotif, этот параметр обычно игнорируется; вместо него используется обычный цвет фона. Для некоторых элементов в системах Windows и Macintosh активный цвет будет использоваться только при нажатой кнопке мыши 1 над элементом.
Имя в командной строке: -activeborderwidth
Имя в базе данных: activeBorderWidth
Класс в базе данных: BorderWidth: Устанавливает неотрицательное значение, определяющее ширину 3D-рамки, нарисованной вокруг активных элементов. Определение активных элементов см. выше. Значение может иметь любой формат, допустимый для Tk_GetPixels. Этот параметр обычно доступен только в виджетах, отображающих более одного элемента одновременно (например, в меню, но не в кнопках).
Имя в командной строке: -activeforeground
Имя в базе данных: activeForeground
Класс в базе данных: Background: Устанавливает цвет переднего плана, используемый при отображении активных элементов. Определение активных элементов см. выше.
Имя в командной строке: -anchor
Имя в базе данных: anchor
Класс в базе данных: Anchor: Устанавливает способ отображения информации в виджете (например, текста или битовой карты) в виджете. Должно быть одним из значений n, ne, e, se, s, sw, w, nw или center. Например, nw означает отображение информации так, чтобы её верхний левый угол совпадал с верхним левым углом виджета.
Имя в командной строке: -background or -bg
Имя в базе данных: background
Класс в базе данных: Background: Устанавливает цвет обычного фона при отображении виджета.
Имя в командной строке: -bitmap
Имя в базе данных: bitmap
Класс в базе данных: Bitmap: Устанавливает битовую карту для отображения в виджете в любом формате, допустимом для Tk_GetBitmap. Точный способ отображения битовой карты может быть изменён другими параметрами, такими как -anchor или -justify. Как правило, если этот параметр задан, он переопределяет другие параметры, задающие текстовое значение для отображения в виджете, но это контролируется параметром -compound; параметр -bitmap может быть сброшен на пустую строку, чтобы снова включить отображение текста. В виджетах, которые поддерживают оба параметра -bitmap и -image, -image обычно переопределяет -bitmap.
Имя в командной строке: -borderwidth or -bd
Имя в базе данных: borderWidth
Класс в базе данных: BorderWidth: Устанавливает неотрицательное значение, определяющее ширину 3D-рамки, которая рисуется вокруг внешней стороны виджета (если такая рамка рисуется; параметр -relief обычно определяет это). Это значение также может использоваться при рисовании 3D-эффектов внутри виджета. Значение может иметь любой формат, допустимый для Tk_GetPixels.
Имя в командной строке: -cursor
Имя в базе данных: cursor
Класс в базе данных: Cursor: Устанавливает курсор мыши для виджета. Значение может иметь любой формат, допустимый для Tk_GetCursor. Кроме того, если указана пустая строка, это означает, что виджет должен обратиться к своему родителю для указания курсора.
Имя в командной строке: -compound
Имя в базе данных: compound
Класс в базе данных: Compound: Указывает, должен ли виджет отображать текст и битовые карты/изображения одновременно, и если да, то где должна быть расположена битовая карта/изображение относительно текста. Должно быть одним из значений none, bottom, top, left, right или center. Например, значение none (по умолчанию) указывает, что битовая карта или изображение (если определены) должны быть отображены вместо текста, значение left указывает, что битовая карта или изображение должны быть отображены слева от текста, а значение center указывает, что битовая карта или изображение должны быть отображены поверх текста.
Имя в командной строке: -disabledforeground
Имя в базе данных: disabledForeground
Класс в базе данных: DisabledForeground: Устанавливает цвет переднего плана, используемый при рисовании отключенного элемента. Если параметр задан как пустая строка (что обычно имеет место на монохромных дисплеях), отключенные элементы рисуются с обычным цветом переднего плана, но затемняются за счёт рисования с пунктирной заливкой.
Имя в командной строке: -exportselection
Имя в базе данных: exportSelection
Класс в базе данных: ExportSelection: Указывает, должен ли выбранный элемент в виджете также быть выделен в X. Значение может иметь любой формат, принятый Tcl_GetBoolean, такой как true, false, 0, 1, yes или no. Если выделение экспортируется, то выделение в виджете отменяет текущее выделение X, выделение вне виджета отменяет любое выделение виджета, и виджет будет реагировать на запросы получения выделения, когда у него есть выделение. По умолчанию виджеты обычно экспортируют выделения.
Имя в командной строке: -font
Имя в базе данных: font
Класс в базе данных: Font: Устанавливает шрифт, который используется для рисования текста внутри виджета. Значение может иметь любой формат, описанный в справке font в разделе FONT DESCRIPTION.
Имя в командной строке: -foreground or -fg
Имя в базе данных: foreground
Класс в базе данных: Foreground: Устанавливает цвет обычного переднего плана при отображении виджета.
Имя в командной строке: -highlightbackground
Имя в базе данных: highlightBackground
Класс в базе данных: HighlightBackground: Устанавливает цвет, отображаемый в области выделения перемещения, когда виджет не имеет фокуса ввода.
Имя в командной строке: -highlightcolor
Имя в базе данных: highlightColor
Класс в базе данных: HighlightColor: Устанавливает цвет, используемый для прямоугольника выделения перемещения, который рисуется вокруг виджета при наличии фокуса ввода.
Имя в командной строке: -highlightthickness
Имя в базе данных: highlightThickness
Класс в базе данных: HighlightThickness: Устанавливает неотрицательное значение, определяющее ширину прямоугольника выделения, рисуемого вокруг виджета при наличии фокуса ввода. Значение может иметь любой формат, допустимый для Tk_GetPixels. Если значение равно нулю, выделение фокуса вокруг виджета не рисуется.
Имя в командной строке: -image
Имя в базе данных: image
Класс в базе данных: Image: Устанавливает изображение для отображения в виджете, которое должно быть создано с помощью команды image create. Как правило, если указан параметр -image, он переопределяет другие параметры, задающие битовую карту или текстовое значение для отображения в виджете, хотя это контролируется параметром -compound; параметр -image может быть сброшен на пустую строку, чтобы снова включить отображение битовой карты или текста.
Имя в командной строке: -insertbackground
Имя в базе данных: insertBackground
Класс в базе данных: Foreground: Устанавливает цвет, используемый в качестве фона в области, занимаемой курсором вставки. Этот цвет обычно переопределяет либо обычный фон виджета (или фон выделения, если курсор вставки попадает в выделение).
Имя в командной строке: -insertborderwidth
Имя в базе данных: insertBorderWidth
Класс в базе данных: BorderWidth: Устанавливает неотрицательное значение, определяющее ширину 3D-рамки, рисуемой вокруг курсора вставки. Значение может иметь любой формат, допустимый для Tk_GetPixels.
Имя в командной строке: -insertofftime
Имя в базе данных: insertOffTime
Класс в базе данных: OffTime: Устанавливает неотрицательное целое число, обозначающее количество миллисекунд, в течение которого курсор вставки должен оставаться «выключенным» в каждом цикле мигания. Если этот параметр равен нулю, курсор не мигает: он постоянно включён.
Имя в командной строке: -insertontime
Имя в базе данных: insertOnTime
Класс в базе данных: OnTime: Устанавливает неотрицательное целое число, обозначающее количество миллисекунд, в течение которого курсор вставки должен оставаться «включённым» в каждом цикле мигания.
Имя в командной строке: -insertwidth
Имя в базе данных: insertWidth
Класс в базе данных: InsertWidth: Устанавливает значение, обозначающее общую ширину курсора вставки. Значение может иметь любой формат, допустимый для Tk_GetPixels. Если для курсора вставки была задана рамка (с помощью параметра -insertborderwidth), рамка будет нарисована внутри ширины, заданной параметром -insertwidth.
Имя в командной строке: -jump
Имя в базе данных: jump
Класс в базе данных: Jump: Для виджетов со слайдером, который можно перетаскивать для изменения значения, таких как полосы прокрутки, этот параметр определяет, когда производятся уведомления о изменениях значения. Значение параметра должно быть булевым, принятым Tcl_GetBoolean. Если значение равно false, обновления выполняются непрерывно при перетаскивании слайдера. Если значение равно true, обновления откладываются до отпускания кнопки мыши, чтобы завершить перетаскивание; в этот момент делается одно уведомление (значение «прыгает», а не меняется плавно).
Имя в командной строке: -justify
Имя в базе данных: justify
Класс в базе данных: Justify: Когда в виджете отображается несколько строк текста, этот параметр определяет, как строки выстраиваются друг относительно друга. Должно быть одним из значений left, center или right. Left означает, что левые края строк выстраиваются друг относительно друга, center означает, что центры строк выровнены, а right означает, что правые края строк выровнены.

Имя в командной строке: -orient
Имя базы данных: orient
Класс базы данных: Orient: Для виджетов, которые могут размещать себя как по горизонтали, так и по вертикали, например, полосы прокрутки, этот параметр определяет, какая ориентация должна быть использована. Должно быть либо горизонтально, либо вертикально, или аббревиатура одного из них.
Имя в командной строке: -padx
Имя базы данных: padX
Класс базы данных: Pad: Указывает ненулевое значение, определяющее дополнительное пространство, необходимое для виджета в направлении X. Значение может иметь любой формат, приемлемый для Tk_GetPixels. При вычислении требуемого размера окна виджет добавит это значение к обычно необходимой ширине (определяемой шириной отображаемых элементов в виджете); если менеджер геометрии может удовлетворить этому запросу, виджет получит дополнительное внутреннее пространство слева и/или справа от отображаемого содержимого. Большинство виджетов используют этот параметр только для отступа текста: если они отображают растровое изображение или изображение, то обычно игнорируют параметры отступа.
Имя в командной строке: -pady
Имя базы данных: padY
Класс базы данных: Pad: Указывает ненулевое значение, определяющее дополнительное пространство, необходимое для виджета в направлении Y. Значение может иметь любой формат, приемлемый для Tk_GetPixels. При вычислении требуемого размера окна виджет добавит это значение к обычно необходимой высоте (определяемой высотой отображаемых элементов в виджете); если менеджер геометрии может удовлетворить этому запросу, виджет получит дополнительное внутреннее пространство сверху и/или снизу от отображаемого содержимого. Большинство виджетов используют этот параметр только для отступа текста: если они отображают растровое изображение или изображение, то обычно игнорируют параметры отступа.
Имя в командной строке: -relief
Имя базы данных: relief
Класс базы данных: Relief: Указывает желаемый 3D-эффект для виджета. Допустимые значения: raised, sunken, flat, ridge, solid и groove. Значение указывает, как внутренняя часть виджета должна выглядеть относительно внешней; например, raised означает, что внутренняя часть виджета должна выглядеть выступающей из экрана по отношению к внешней части виджета.
Имя в командной строке: -repeatdelay
Имя базы данных: repeatDelay
Класс базы данных: RepeatDelay: Указывает количество миллисекунд, в течение которого кнопка или клавиша должна быть нажата, прежде чем начнется автоматическое повторение. Используется, например, для стрелок вверх и вниз в полосах прокрутки.
Имя в командной строке: -repeatinterval
Имя базы данных: repeatInterval
Класс базы данных: RepeatInterval: Используется совместно с -repeatdelay: после начала автоматического повторения этот параметр определяет количество миллисекунд между повторениями.
Имя в командной строке: -selectbackground
Имя базы данных: selectBackground
Класс базы данных: Foreground: Указывает цвет фона, который нужно использовать при отображении выделенных элементов.
Имя в командной строке: -selectborderwidth
Имя базы данных: selectBorderWidth
Класс базы данных: BorderWidth: Указывает ненулевое значение, определяющее ширину 3D-рамки, которая должна быть нарисована вокруг выделенных элементов. Значение может иметь любой формат, приемлемый для Tk_GetPixels.
Имя в командной строке: -selectforeground
Имя базы данных: selectForeground
Класс базы данных: Background: Указывает цвет переднего плана, который нужно использовать при отображении выделенных элементов.
Имя в командной строке: -setgrid
Имя базы данных: setGrid
Класс базы данных: SetGrid: Указывает логическое значение, определяющее, контролирует ли этот виджет сетку изменения размеров для своего окна верхнего уровня. Этот параметр обычно используется в виджетах текста, где информация в виджете имеет естественный размер (размер символа), и имеет смысл, чтобы размеры окна были целыми числами этих единиц. Эти естественные размеры окон образуют сетку. Если параметр -setgrid установлен в значение true, виджет будет взаимодействовать с диспетчером окон, чтобы при интерактивном изменении пользователем размеров окна, содержащего виджет, размеры окна отображались пользователю в единицах сетки и размер окна ограничивался целыми числами единиц сетки. Дополнительные сведения см. в разделе УПРАВЛЕНИЕ ГЕОМЕТРИЕЙ СЕТКИ в справочной записи 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: Указывает цвет, используемый для прямоугольных областей желоба в виджетах, таких как полосы прокрутки и шкалы. Этот параметр игнорируется для полос прокрутки в Windows (родной виджет не распознаёт этот параметр).
Имя в командной строке: -underline
Имя базы данных: underline
Класс базы данных: Underline: Указывает целочисленный индекс символа, который необходимо подчеркнуть в виджете. Этот параметр используется стандартными привязками для реализации перемещения по клавиатуре для кнопок меню и пунктов меню. 0 соответствует первому символу отображаемого текста в виджете, 1 — следующему символу и так далее.
Имя в командной строке: -wraplength
Имя базы данных: wrapLength
Класс базы данных: WrapLength: Для виджетов, которые могут выполнять перенос слов, этот параметр определяет максимальную длину строки. Строки, длина которых превышает эту длину, переносятся на следующую строку, так что ни одна строка не будет длиннее указанной длины. Значение может быть указано в любом стандартном формате для экранных расстояний. Если это значение меньше или равно 0, то переноса строк не выполняется: строки будут разрываться только на символах новой строки в тексте.
Имя в командной строке: -xscrollcommand
Имя базы данных: xScrollCommand
Класс базы данных: ScrollCommand: Указывает префикс для команды, используемой для связи с горизонтальными полосами прокрутки. Когда область просмотра в окне виджета изменяется (или когда происходит что-либо другое, что может изменить отображение в полосе прокрутки, например, изменение общего размера содержимого виджета), виджет создаст Tcl-команду, объединив команду прокрутки и два числа. Каждое из чисел — это дробь от 0 до 1, которая указывает позицию в документе. 0 — начало документа, 1 — конец, .333 — позиция на одну треть пути по документу и так далее. Первая дробь указывает первую информацию в документе, которая видна в окне, а вторая дробь указывает информацию, непосредственно следующую за последней видимой частью. Затем команда передаётся в интерпретатор Tcl для выполнения. Обычно параметр -xscrollcommand состоит из имени пути виджета полосы прокрутки, за которым следует «set», например, «.x.scrollbar set»: это приведет к обновлению полосы прокрутки всякий раз, когда область просмотра в окне изменяется. Если этот параметр не указан, то никакая команда не будет выполнена.
Имя в командной строке: -yscrollcommand
Имя базы данных: yScrollCommand
Класс базы данных: ScrollCommand: Указывает префикс для команды, используемой для связи с вертикальными полосами прокрутки. Этот параметр обрабатывается так же, как и параметр -xscrollcommand, за исключением того, что он используется для вертикальных полос прокрутки и предоставляется виджетами, которые поддерживают вертикальную прокрутку. См. описание параметра -xscrollcommand для получения подробной информации о том, как используется этот параметр.

См. также

colors, cursors, font

Licensed under Tcl/Tk terms
https://www.tcl.tk/man/tcl/TkCmd/options.htm