contents.gifprev1.gifnext1.gif

CURSOR_VERTICAL

Description:

CURSOR_VERTICAL moves cursor up or down by the specified number of rows. CURSOR_VERTICAL is not tied to text, so you may move to mid-tab, past end of line, and past end of buffer positions. CURSOR_VERTICAL provides free cursor movement within a window, can move beyond the border of the window only if CROSS_WINDOW_BOUNDS is set ON, and can move to any point within the window whether or not there is text at the cursor position. If the cursor is moved to a new window, the new window is made the current window. CURSOR_VERTICAL does not pad the current cursor position with spaces and returns the actual number of lines moved.

Syntax:

integer := CURSOR_VERTICAL (integer)

Example:

The following moves the cursor five rows towards the bottom of the window.

CURSOR_VERTICAL (5);

Related Builtins:

CURSOR_HORIZONTAL

MOVE_VERTICAL

SET(CROSS_WINDOW_BOUNDS)

SET(SCROLLING)