INPUT-GET-TEXT Action

This document covers the following topics:

Description

Retrieves text in a line of the Edit Area Control or in an Input Field Control (from a position onwards).

Parameters

Name/Data Type Explanation
HANDLE OF EDITAREA or

INPUTFIELD

 Input

Specifies an Edit Area Control or an Input Field Control.

Position-from (I4) Input

The text is retrieved from this position onwards.

Line length (I4) Input/Output

The number of the characters to be retrieved (must be 1 to 253).

Line text (A253) Output

The retrieved text will be copied into this text string.

End (L) Output

Becomes TRUE if the last retrieved character was the last character in the dialog element. If End is TRUE, the number of retrieved characters is returned in the Line length parameter.

Response (I4) Output

Natural error (if applicable).

Example: 

 
   #POSITION := 8     /* Set input 
   #LINE-LENGTH := 22 /* values 
   PROCESS GUI ACTION INPUT-GET-TEXT WITH #EA-1 #POSITION-FROM #LINE-LENGTH 
      #LINE-TEXT #END GIVING #RESPONSE 
   #IF-1.STRING := #POSITION    /* Display output values 
   #IF-2.STRING := #LINE-LENGTH /* in Input Field Controls 
   #IF-3.STRING := #TEXT