radiobutton

Имя в командной строке: -command
Имя базы данных: command
Класс базы данных: Command: Указывает Tcl-команду, которая должна быть связана с кнопкой. Эта команда обычно вызывается при отпускании левой кнопки мыши над окном кнопки. Глобальная переменная кнопки (опция -variable) будет обновлена перед вызовом команды.
Имя в командной строке: -height
Имя базы данных: height
Класс базы данных: Height: Указывает желаемую высоту кнопки. Если в кнопке отображается изображение или растровый рисунок, значение указывается в единицах экрана (т.е. в любом формате, приемлемом для Tk_GetPixels); для текста – в строках текста. Если эта опция не указана, желаемая высота кнопки вычисляется из размера отображаемого в ней изображения, растрового рисунка или текста.
Имя в командной строке: -indicatoron
Имя базы данных: indicatorOn
Класс базы данных: IndicatorOn: Указывает, нужно ли отображать индикатор. Должно быть истинным или ложным значением. Если ложно, опция -relief игнорируется, и рельеф виджета всегда будет углубленным, если виджет выбран, и выпуклым в противном случае.
Имя в командной строке: -selectcolor
Имя базы данных: selectColor
Класс базы данных: Background: Указывает цвет фона, который будет использоваться, когда кнопка выбрана. Если -indicatoron имеет значение истина, цвет применяется к индикатору. В Windows этот цвет используется в качестве фона индикатора независимо от состояния выбора. Если -indicatoron имеет значение ложь, этот цвет используется в качестве фона всего виджета вместо -background или -activeBackground, когда виджет выбран. Если задано пустой строкой, то особый цвет для отображения, когда виджет выбран, не используется.
Имя в командной строке: -offrelief
Имя базы данных: offRelief
Класс базы данных: OffRelief: Указывает рельеф кнопки, когда индикатор не отображается, и кнопка не выбрана. Значение по умолчанию – «выпуклый». Установив эту опцию в «плоский» и установив -indicatoron в ложь и -overrelief в «выпуклый», достигается эффект плоской кнопки, которая становится выпуклой при наведении курсора и углубленной при активации. Такое поведение обычно демонстрируют радиокнопки «Выровнять влево», «Выровнять вправо» и «Центрировать» на панели инструментов текстового редактора, например.
Имя в командной строке: -overrelief
Имя базы данных: overRelief
Класс базы данных: OverRelief: Указывает альтернативный рельеф для радиокнопки, который будет использоваться, когда курсор мыши находится над виджетом. Эту опцию можно использовать для создания кнопок на панели инструментов, настроив -relief flat -overrelief raised. Если значение этой опции является пустой строкой, альтернативный рельеф не используется, когда курсор мыши находится над радиокнопкой. Пустая строка является значением по умолчанию.
Имя в командной строке: -selectimage
Имя базы данных: selectImage
Класс базы данных: SelectImage: Указывает изображение для отображения (вместо опции -image) при выборе радиокнопки. Эта опция игнорируется, если не указана опция -image.
Имя в командной строке: -state
Имя базы данных: state
Класс базы данных: State: Указывает одно из трёх состояний радиокнопки: normal, active или disabled. В нормальном состоянии радиокнопка отображается с использованием опций -foreground и -background. Активное состояние обычно используется, когда указатель находится над радиокнопкой. В активном состоянии радиокнопка отображается с использованием опций -activeforeground и -activebackground. Отключенное состояние означает, что радиокнопка должна быть неактивной: стандартные привязки откажутся от активации виджета и проигнорируют нажатия клавиш мыши. В этом состоянии радиокнопка отображается с использованием опций -disabledforeground и -background.
Имя в командной строке: -tristateimage
Имя базы данных: tristateImage
Класс базы данных: TristateImage: Указывает изображение для отображения (вместо опции -image) при выборе радиокнопки. Эта опция игнорируется, если не указана опция -image.
Имя в командной строке: -tristatevalue
Имя базы данных: tristateValue
Класс базы данных: Value: Указывает значение, которое приводит к отображению радиокнопки в режиме множественного выбора, также известном как режим трёх состояний. Значение по умолчанию – «».
Имя в командной строке: -value
Имя базы данных: value
Класс базы данных: Value: Указывает значение, которое должно быть сохранено в переменной, связанной с кнопкой, всякий раз, когда эта кнопка выбирается.
Имя в командной строке: -variable
Имя базы данных: variable
Класс базы данных: Variable: Указывает имя глобальной переменной, которая должна быть установлена всякий раз, когда эта кнопка выбирается. Изменения в этой переменной также приводят к выбору или снятию выбора с кнопки. Значение по умолчанию – selectedButton.
Имя в командной строке: -width
Имя базы данных: width
Класс базы данных: Width: Указывает желаемую ширину кнопки. Если в кнопке отображается изображение или растровый рисунок, значение указывается в единицах экрана (т.е. в любом формате, приемлемом для Tk_GetPixels); для текста – в символах. Если эта опция не указана, желаемая ширина кнопки вычисляется из размера отображаемого в ней изображения, растрового рисунка или текста.

Описание

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

Радиокнопка – это виджет, отображающий текстовую строку, растровый рисунок или изображение и ромб или круг, называемый индикатором. Если отображается текст, весь текст должен быть в одном шрифте, но он может занимать несколько строк на экране (если он содержит символы новой строки или если происходит перенос из-за опции -wraplength), и один из символов может быть подчёркнут с помощью опции -underline. Радиокнопка обладает всеми свойствами обычной кнопки: она может отображать себя тремя способами в зависимости от опции -state; она может быть отображена выпуклой, углублённой или плоской; она может мигать; и она вызывает Tcl-команду при нажатии левой кнопки мыши на кнопку.

Кроме того, радиокнопки могут быть выбраны. Если радиокнопка выбрана, индикатор обычно отображается с выбранным внешним видом, и переменная Tcl, связанная с радиокнопкой, устанавливается в определённое значение (обычно 1). В Unix индикатор отображается с углублённым рельефом и специальным цветом. В Windows индикатор отображается с круглой меткой внутри. Если радиокнопка не выбрана, индикатор отображается с невыбранным внешним видом, а связанная переменная устанавливается в другое значение (обычно 0). Индикатор отображается без круглой метки внутри. Обычно несколько радиокнопок используют одну и ту же переменную, а значение переменной указывает, какая радиокнопка выбрана. Когда радиокнопка выбирается, она устанавливает значение переменной, чтобы указать этот факт; каждая радиокнопка также отслеживает значение переменной и автоматически выбирает или отменяет выбор, когда значение переменной изменяется. Если значение переменной совпадает со значением -tristatevalue, то радиокнопка отображается в режиме трёх состояний. Этот режим используется для указания смешанных или множественных значений. (Это используется, когда радиокнопка представляет состояние нескольких элементов.) По умолчанию используется переменная selectedButton; её содержимое указывает имя выбранной кнопки или пустую строку, если ни одна кнопка, связанная с этой переменной, не выбрана. Имя переменной радиокнопки, а также переменная, в которую будет храниться значение, могут быть изменены с помощью опций в командной строке или в базе данных опций. Опции конфигурации также могут быть использованы для изменения способа отображения индикатора (или для того, чтобы он вообще не отображался). По умолчанию радиокнопка настроена на выбор себя при нажатии кнопки мыши.

Команда виджета

Команда radiobutton создаёт новую Tcl-команду с именем pathName. Эта команда может использоваться для вызова различных операций над виджетом. Она имеет следующий общий вид:

pathName option ?arg arg ...?

Option и args определяют точное поведение команды. Для виджетов радиокнопок возможны следующие команды:

pathName cget option: Возвращает текущее значение конфигурационного параметра, заданного option. Option может принимать любые значения, допускаемые командой radiobutton.
pathName configure ?option? ?value option value ...?: Запрос или изменение конфигурационных параметров виджета. Если option не указан, возвращается список, описывающий все доступные параметры для pathName (см. Tk_ConfigureInfo для информации о формате этого списка). Если option указан без value, команда возвращает список, описывающий указанный параметр (этот список будет идентичен соответствующей подсписку возвращаемому, если option не указан). Если указаны одна или несколько пар option-value, команда изменяет указанный(ые) параметр(ы) виджета на заданное(ые) значение(я); в этом случае команда возвращает пустую строку. Option может принимать любые значения, допускаемые командой radiobutton.
pathName deselect: Отменяет выделение радиокнопки и устанавливает связанную переменную в пустую строку. Если эта радиокнопка не была выделена, команда не оказывает никакого влияния.
pathName flash: Мигает радиокнопкой. Это достигается повторным отображением радиокнопки несколько раз, чередуя активные и обычные цвета. По окончании мигания радиокнопка остается в том же состоянии (нормальное/активное), что и при вызове команды. Эта команда игнорируется, если состояние радиокнопки disabled.
pathName invoke: Делает то же, что и при вызове пользователем радиокнопки с помощью мыши: выбирает кнопку и вызывает связанную команду Tcl, если она есть. Значение возврата — это значение возврата команды Tcl или пустая строка, если никакая команда не ассоциирована с радиокнопкой. Эта команда игнорируется, если состояние радиокнопки disabled.
pathName select: Выделяет радиокнопку и устанавливает связанную переменную в значение, соответствующее этому виджету.

Связки

Tk автоматически создает связки классов для радиокнопок, которые обеспечивают следующее поведение по умолчанию:

В системах Unix радиокнопка активируется при наведении курсора мыши и деактивируется при его уходе с радиокнопки. В системах Mac и Windows, при нажатии левой кнопки мыши на радиокнопке, кнопка активируется, пока курсор мыши находится внутри кнопки, и деактивируется, когда курсор мыши выходит за пределы кнопки.
При нажатии левой кнопки мыши на радиокнопке она вызывается (становится выделенной и вызывается связанная с ней команда Tcl, если она есть).
Если у радиокнопки фокус ввода, нажатие клавиши пробела вызывает радиокнопку.

Если состояние радиокнопки disabled, то ни одно из вышеперечисленных действий не происходит: радиокнопка не реагирует никак.

Поведение радиокнопок можно изменить, определив новые связки для отдельных виджетов или переопределив связки классов.

См. также

checkbutton, labelframe, listbox, options, scale, ttk::radiobutton

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