insert Command

Inserts a text string after the current line.

Scope: File

Syntax

Parameter

TextString 
The text string that forms the content of the line. It can be blank.

Description

The insert command inserts a new line made up of TextString after the current line. The new line becomes the current line and inherits the current font, formatting, and class settings. The new line merges with the following line if a following line is available.

Note: Leading blanks in front of the text string are included in the new line but trailing blanks are ignored.

Example

To insert a new line of text, This is a new line of text., after the current line, type:

insert This is a new line of text.

If the current line is followed by another line (and not by a break), the inserted line is merged with the following line.

API Return Code

-5 
You cannot make changes to the file because the readonly parameter is set to on.

element Parameter
add Command