contents.gifprev1.gifnext1.gif

MODIFY_RANGE

Description:

MODIFY_RANGE is used to dynamically alter the characteristics of a range passed as the first parameter. The range is defined by the second and third parameters. These second and third parameters can be markers or the following keywords: LINE_BEGIN, BUFFER_BEGIN, LINE_END, or BUFFER_END.

An optional fourth and last parameter can be used to change the video attributes of the range given as the first parameter. Valid fourth parameter arguments are: BOLD, NONE, CYAN, RED, BLINK, BLACK, GREEN, WHITE, REVERSE, BLUE, MAGENTA, YELLOW, or UNDERLINE.

Syntax:

MODIFY_RANGE (range, {marker | keyword}, {marker | keyword} [, attribute ])

Examples:

The following changes the video attribute of the range fred$range to blink.

MODIFY_RANGE (fred$range, , , blink);

The following changes the beginning marker of the range fred$range to LINE_BEGIN and changes the video attributes to none.

MODIFY_RANGE (fred$range, LINE_BEGIN, m2, NONE);

Errors:

TPU$_BADKEY Invalid keyword.

TPU$_NOTSAMEBUF The first and second markers are in different buffers.