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
