Please enable JavaScript to view this site.

Reviewed and revised December 2023

tab(-10, AG_SYSBCLR); bgsys, bgwin, fgtext {,opcode}; chr(127);     Tab(-10,x) Syntax Notes

AG_SYSBCLR (26), formerly AG_SETWINCLR, provides a way to associate some of the A-Shell color palette numbers with the most important Windows colors (the ‘system’ gray commonly used for the background of windows and dialogs, the color used for the background of edit controls, and the standard text color).

This function has both a subroutine and a print tab implementation.

Parameters

bgsys

A single digit (0-7) indicating the color number from the A-Shell background palette to be associated with the standard Windows gray (aka "button face" or "dialog background" color). You may also specify "-1" to leave this color alone (in order to set one of the others).<CR>

bgwin

A single digit (0-7) indicating the color number from the A-Shell background palette to be associated with the standard Windows color used for the background of edit controls and list boxes (usually white). You may also specify "-1" to leave this color alone (in order to set one of the others).<CR>

fgtext

A single digit (0-7) indicating the color number from the A-Shell foreground palette to be associated with the standard Windows text color (usually black). You may also specify "-1" to leave this color alone (in order to set one of the others). <CR>

opcode

An optional digit indicating the operation: 0 to set the color associates, 1 to query them. The default is 0 to set.

Response

If opcode is set to 1, then a string formatted as "#,#,#" will be forced into the keyboard buffer to return the current values of the color associations (in the order of the parameters as shown above).

Examples

! set bg 0 to system gray, bg 1 to edit bg color, and fg 1 to text color

? TAB(-10,G_SYSBCLR);"0,1,0";chr(127);

! query the current colors

? TAB(-10,G_SYSBCLR);0,0,0,1";chr(127);

input bgsys,bgwin,ftext

See Also

Created with Help+Manual 9 and styled with Premium Pack Version 5 © by EC Software