Description:
CURSOR_HORIZONTAL moves cursor left/right by count columns. The number of
columns to move is passed as a parameter and is not tied to text, thus you may
move to mid-tab, past end of line, and past end of buffer positions. In other
words, you can move to any point within the window whether or not there is text at
the cursor position.
CURSOR_HORIZONTAL provides free cursor movement within a window but cannot
move beyond the border of the window in any direction. If NODISPLAY mode is ON,
CURSOR_HORIZONTAL has no effect. Lastly, CURSOR_HORIZONTAL does not pad the
current cursor position with spaces and always returns the actual number of columns
moved.
Syntax:
integer := CURSOR_HORIZONTAL (integer)
Examples:
The following moves the cursor five characters to the right.
CURSOR_HORIZONTAL (5);
The following moves the cursor to the left margin of the line using the
CURRENT_OFFSET builtin.
CURSOR_HORIZONTAL (-CURRENT_OFFSET);
Related Builtins:
CURSOR_HORIZONTAL