Block: _getText

Block: _getText

Returns the character value assigned to a block

Value: Inherited from Widget

Syntax
Details
Example

Syntax

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

Argument Type Description

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

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

Details

If a block 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 block that has a numeric value.

Example

If the value print was assigned to the block in the Value on Selection window, _getText assigns the value print to the SCL variable TEXT:

   length text $ 24;
   call notify('block1','_get_text_',text);
   if (text='print') then
      _msg_='The report will be printed.';

Chapter Contents
Previous
Next
Top of Page