Radio Box: _getText

Radio Box: _getText

Returns the character value assigned to the active button in the radio box

Inherited from Widget

Syntax
Details
Example

Syntax

CALL NOTIFY (radio-box-name, '_getText', text-value);

Argument Type Description

text-value
C returns the character value assigned to the active button. If the active button does not have a value, then the button's label is returned.

Argument	Type	Description
text-value	C	returns the character value assigned to the active button. If the active button does not have a value, then the button's label is returned.

Details

If the radio box button has been assigned a numeric value in the Value on Selection window, the _getText method causes a program halt. Use the _getValue method to return the value of a button that has a numeric value.

Example

If the return value Printing was assigned to the radio box, _getText returns the value Printing and assigns it to the variable TEXT:

   length text $ 24;
   call notify('rbox1','_get_text_',text);
   if (text='Printing') then
      _msg_='You have selected the printing 
            option.';

Chapter Contents
Previous
Next
Top of Page