NAME
radioButton - Create and manipulate a radio button
SYNOPSIS
- radioButton ?-option optionVal ...?
OPTIONS
- -variable
- (Required option)
Name of a (global) variable which is changed when the state
of the button changes. All radio buttons with the
same variable are in one group. If the variable does
not exist, it is created and set to the value of the
first button in the group. If the variable does exist
and it's value corresponse to the value of a button in
this group, this button is selected. If the value of
variable is set externaly (e.g. via the set),
the corresponding button in the group is selected and
its command executed.
type: string
default: ""
- -value
- (Required option)
Value to store in the button's associated variable
whenever this button is selected.
type: string
default: ""
- -text
- text or icon of the button
type: string
default: ""
- -command
- Tcl command which is executed when the button is pressed.
type: string
default: ""
- -indicatorOn
- Determines whether or not the toggle button is drawn on
screen.
type: boolean
default: true
- -tooltip
- Message that appear next to this widget when the mouse
pointer is held over it for a short amount of time.
type: string
default: ""
- -sensitive
- Wheather or not the item is sensitve to user input.
type: boolean
default: 1
DESCRIPTION
A radio button is like a
checkbutton, but in a group of
radio buttons only one can be selected. All radio buttons of
one group share one variable. This variable contains always
the value of the active radio button.
WIDGET COMMANDS
The radioButton command creates a new Tcl command
whose name is an ID returned on widget creation. This command may be
used to invoke various operations on the widget. It has the following
general form:
ID option ?arg arg ...?
option and arg determine the exact behavior of the
command. The following commands are possible for radioButton widgets:
- ID invoke
-
Does just what would have happened if the user invoked
the radiobutton with the mouse: selects the button and
invokes its associated Tcl command, if there is one.
This command is ignored if the radiobutton is already selected
or it's state is not sensitve.
KEYWORDS
Copyright © 2001 - 2002 P. G. Baum