trigpos Parameter

Specifies the current position after the live parsing of pending lines has been processed.

Scope: View

Syntax

query trigpos 
set trigpos Number 

Option

Number 
The new current position.

Description

The trigpos parameter sets the current position to be the specified character position in the current line after trigger processing is complete. If trigpos is not set, the current position is saved before trigger processing and restored afterward.

The query trigpos command returns a number that indicates the saved current position. If the position is unknown, a zero is returned. If the position is in the current line, a positive number is returned. If the position is known but is not on the current line, a negative number is returned.

Example

To set the next current position to the seventh character of the line after the trigger processing is complete type:

set trigpos 7 

API Return Codes

-2 
The option specified with the parameter was not valid. Check the syntax requirements for the parameter and try the set command again.

trigger Command