EDIT-LINE-INSERT Action

This document covers the following topics:

Description

Inserts a new line into an Edit Area Control.

Parameters

Name/Data Type Explanation
HANDLE OF EDITAREA Input

Specifies an Edit Area Control.

Line number (I4) Input

The new line will be inserted before this line. If you specify "0", the new line will be appended to the last line of the Edit Area Control .

Line length (I4) Input/Output

The number of characters to be inserted into the new line starting from the first character of "Line text". If you specify "0", an empty line will be inserted. If you specify "-1", the "Line text" string will be copied into the new line, trailing blanks will be removed and the number of copied characters will be returned.

Line text (A) Input

The text string of the line to be inserted.

Note:
If this parameter is a dynamic or large alpha variable, it is possible to insert a line longer than 253 characters.

Response (I4) Output

Natural error (if applicable).

Example: 

   #LINE-NUMBER := 0 
   #LINE-LENGTH := 10 
   #LINE-TEXT := 'Hello!' 
   PROCESS GUI ACTION EDIT-LINE-INSERT WITH #EA-1 #LINE-NUMBER #LINE-LENGTH 
   #LINE-TEXT GIVING #RESPONSE
program