? tab(-10, AG_SYSBCLR); bgsys; comma; bgwin; comma; fgtext {;comma; opcode}; chr(127);

AG_SYSBCLR (formerly SETWINCLR) (26) 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).

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).

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).

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).

opcode

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

Return value

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

Notes

The same function can be accomplished with SET.LIT or MX_SYSBCLR, both of which use AG_SYSBCLR to work in both the local Windows and ATE/UNIX environments.