Document:     radiogroup

Purpose:      Set of routines for coordinating groups of keywords.

Category:     USER INTERFACE

File:         radiogroup.c

Author:       J.P. Terlouw

Description:  These routines allow sets of user input keywords of type
              LOGICAL to be coordinated in groups. With every group
              a user input keyword is associated. This keyword is specified
              when the group is created with the function RadioGroup().

              Member keywords can be added to a group by calling RadioAddKey().
              In this call a value is specified which will be associated
              with the keyword.

              Finally a group can be deleted by calling RadioDeleteGroup().
              It is currently not possible to remove members from a group.

              When a group exists, it behaves as follows:
              - when one of the keywords is set to TRUE, all other keywords
                are set to FALSE. The keyword associated with the group
                will be set to the value associated with the keyword which
                was set to TRUE.
              - When the keyword with value TRUE is set to false,
                the keyword associated with the group will be set to an
                empty value.

Related docs: RadioGroup.dc2, RadioAddKey, RadioDeleteGroup.

See also:     Example program in TESTBED section of source code.

Updates:      May 12, 1999: JPT, Document created.