Check Box: _getText

Check Box: _getText

Returns the character value assigned to a check box

Value: Inherited from Widget

Syntax
Details
Example

Syntax

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

Argument Type Description

text-value
C returns the character value assigned to the check box. If the check box does not have a return value, then the label of the check box is returned. This value is blank if the check box is not active.

Argument	Type	Description
text-value	C	returns the character value assigned to the check box. If the check box does not have a return value, then the label of the check box is returned. This value is blank if the check box is not active.

Details

If a check box 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 check box.

Example

_getText returns the value Printing, which was assigned to the check box in the Value on Selection window, if the user selects the check box; otherwise a blank is returned.

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

Chapter Contents
Previous
Next
Top of Page