Screen functions – Rockwell Automation 1747-PBASE BASIC Development Software Programming Manual User Manual

Page 124

Publication 1746-PM001A-US-P

A-2 BASIC Macro Library

Screen Functions

The following table describes the macro CALLs that you use to perform operations
on the operator screen.

IMPORTANT

Be aware that the screen macro CALLs pertain to the currently
configured program port only. Attempts to direct output to other
ports will be ignored during program translation

Table A.1 Operation Macros

Screen Macro CALLs

Macro

Inputs

Outputs

cls()

Clears the screen for an ANSI standard terminal.

None

home()

Places the cursor in the upper left hand corner of the screen on an
ANSI standard terminal.

None

clr_to_eol()

Clears from cursor to end of line.

None

go_to_xy(%1,%2)

Positions the cursor. %1 column is the x coordinate in the range 1 to
max_col. %2 row is the Y coordinate in the range 1 to max_row.
Max_row and max_col change depending on the display mode.

%1 = Column
(0 < col < 99)
%2 = Row
(0 < row < 99)

None

cursor_up(%1)

Moves the cursor up %1 rows.

%1 = the number of rows
to move the cursor up

None

cursor_down(%1)

Moves the cursor down %1 rows.

%1 = the number of rows
to move the cursor down

None

cursor_right(%1)

Moves the cursor right %1 columns.

%1 = the number of
columns to move the
cursor right

None

cursor_left(%1)

Moves the cursor left %1 columns.

%1 = the number of
columns to move the
cursor left.

None

cursor_save()

Saves the current cursor position.

None

cursor_restore()

Restores the cursor to the saved position.

None

high_intensity()

Prints characters in high intensity.

None

low_intensity()

Prints characters in low intensity.

None

blink()

Prints characters blinking.

None

reverse()

Prints characters in reverse video.

None

conceal_text()

Conceals printed text (no display of characters).

None

foreground_black()

Prints text with the foreground black.

None

foreground_red()

Prints text with the foreground red.

None

foreground_green()

Prints text with the foreground green.

None

foreground_yellow()

Prints text with the foreground yellow.

None

foreground_blue()

Prints text with the foreground blue.

None

foreground_magenta()

Prints text with the foreground magenta.

None

foreground_cyan()

Prints text with the foreground cyan.

None

foreground_white()

Prints text with the foreground white.

None