Push Button: _getText

Push Button: _getText

Returns the character value assigned to a push button

Inherited from Widget

Syntax
Details
Example

Syntax

CALL NOTIFY (push-button-name, '_getText', text-value);

Argument Type Description

text-value
C returns the character value assigned to the push button. This value is blank if the push button is not selected.

Argument	Type	Description
text-value	C	returns the character value assigned to the push button. This value is blank if the push button is not selected.

Details

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

Example

If the value print was assigned to the push button in the Value on Selection window, _getText returns the value print and assigns it to the variable TEXT:

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

Chapter Contents
Previous
Next
Top of Page