EDIT-LINE-SET-TEXT Action

This document covers the following topics:

Description

Replaces text in a line of the Edit Area Control. Note that you can also use this action to

  • insert text by setting parameters "Column from" and "Column to" to the same value (this will be the insertion position); or to

  • delete text by setting the parameter Line length to the value "0".

Parameters

Name/Data Type Explanation
HANDLE OF EDITAREA Input

Specifies an Edit Area Control.

Line number (I4) Input/Output

The text is replaced out of this line.
Column from (I4) Input/Output

The text is replaced from this column onwards.

Column to (I4) Input/Output

The text is replaced up to this column. If you specify "0", the rest of the line is replaced. The last position in the line will be returned.

Line text (A253) Input/Output

Contains the string replacing the string specified with Line number, Column from, Column to.

Line length (I4) Input/Output

The number of "Line text" characters (out of 253) that replace the old string starting from the first character. If you specify "-1", trailing blanks will be removed and the number of characters used will be returned.

Response (I4) Output

Natural error (if applicable).

Example: 

   #LINE-NUMBER := 1       /*Replaces line 1 
   #COLUMN-FROM := 1 
   #COLUMN-TO := 0 
   #LINE-TEXT := 'New text' 
   PROCESS GUI ACTION EDIT-LINE-SET-TEXT WITH #EA-1 #LINE-NUMBER #COLUMN-FROM 
   #COLUMN-TO #LINE-TEXT #LINE-LENGTH GIVING #RESPONSE 
   MOVE #LINE-TEXT TO #EA-1.STRING