Description

Inserts characters into the specified text and place the result in a variable; i.e., used to insert new text into an already existing text value.

Declaration

<AMTEXTINSERT ACTION="text [options]" POSITION="number" INSERTTEXT="text" TARGETTEXT="text" RESULTVARIABLE="text [variable name]">

Example

<AMVARIABLE NAME="thevariable">Hello</AMVARIABLE>
<AMTEXTINSERT ACTION="insert_end" INSERTTEXT=" world" TARGETTEXT="%thevariable%" RESULTVARIABLE="thevariable">
<AMMESSAGEBOX>%thevariable%</AMMESSAGEBOX>

General Tab Parameters

Text to insert into: Specifies target text to insert the new text into.

Text, Required
MARKUP: TEXT="My Name is Joe"

Action to take: Specifies how the text is trimmed.

• insert_beginning: The text is inserted at the beginning of the target text.

• insert_end: The text is inserted at the end of the target text.

• insert_position: The text is inserted at a specific position of the target text.

Text [options], Optional (default: beginning and end)
MARKUP: ACTION="remove_beginning"

Position to insert text: Specifies the position in the current text to insert new text.

Number, Required if ACTION is insert_position
MARKUP: POSITION="24"

Characters to be inserted: Specifies the characters that should be inserted.

Text, Required
MARKUP: INSERTTEXT="Hello"

Populate variable with result: Specifies the variable to receive the new value.

Text [variable name], Required
MARKUP: RESULTVARIABLE="varname"