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