Athena Widget Set - C Language Interface - X Consortium ... - X.Org

Simple Widgetsnotify()When the Toggle widget is in the set state this actioncalls all functions in the callback list named by thecallback resource. The value of the call_data argumentin these callback functions is undefined.When a bitmap of depth greater that one (1) is specified the set(), unset(), and reset()actions have no effect, since there are no foreground and background colors usedin a multi-plane pixmap.Radio GroupsThere are typically two types of radio groups desired by applications. The defaulttranslations for the Toggle widget implement a "zero or one of many" radio group.This means that there may be no more than one Toggle widget active, but thereneed not be any Toggle widgets active.The other type of radio group is "one of many" and has the more strict policy thatthere will always be exactly one radio button active. Toggle widgets can be usedto provide this interface with a slight modification to the translation table of eachToggle in the group.: highlight(Always): unhighlight(),: set() notify()This translation table will not allow any Toggle to be unset except as a result ofanother Toggle becoming set. It is the application programmer's responsibility tochoose an initial state for the radio group by setting the state resource of one ofits member widgets to True.Convenience RoutinesThe following functions allow easy access to the Toggle widget's radio group functionality.Changing the Toggle's Radio Group.To enable an application to change the Toggle's radio group, add the Toggle to aradio group, or remove the Toggle from a radio group, use XawToggleChangeRadioGroup.void XawToggleChangeRadioGroup( radio_group);wradio_groupSpecifies the Toggle widget.Specifies any Toggle in the new radio group. If NULLthen the Toggle will be removed from any radio groupof which it is a member.If a Toggle is already set in the new radio group, and the Toggle to be added isalso set then the previously set Toggle in the radio group is unset and its callbackprocedures are invoked. Finding the Currently selected Toggle in a radio group ofToggles56