radioButton
Author: Peter G. Baum (peter@dr-baum.net)
Keywords: gnocl, Tcl, gtk, gnome

## 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