beautypg.com

Scrntext – Visara Master Console Center Scripting Guide User Manual

Page 181

background image

Chapter 5 Script Commands

Scripting Guide

181

SCRNTEXT

Syntax:

SCRNTEXT( %Port, %Start, %Length) ==> $Text

Description:

A full or partial screen snapshot. Returns characters from a console
screen.

Action:

The characters beginning at absolute position specified by “Start”, and
continuing for the specified “Length” on the console represented by

“Port” are returned as a string. In effect, a screen snapshot is taken of

the specified area.

Parameters:

%Port. Numeric expression. The assigned console port number. Refer

to Ports on page 24 for more information.
%Start. Numeric expression. The absolute position to begin copying

characters from the console. The minimum value is 1 and the

maximum value is the console’s row quantity * its column quantity.
%Length. Numeric expression. The quantity of characters to copy

from the console. The minimum value is 1 and the maximum value is

the console’s row quantity * its column quantity less the Start
parameter.

Returns:

String value. The characters copied from the console.

Notes:

SCRNTEXT() is not intended for capturing the printer console text.

Use the QREAD() command for reading the printer console.

Example:

N/A

See Also:

ASCRN