Syntax and description

external.sysColor( constant )  - (read), color setting. Gets a standard system color setting corresponding to the passed constant. Sample:
document.bgColor = external.sysColor( COLOR_BTNFACE );
Note: constants defined in the alpframehelpers.js file are used.

Remarks

Color constants defined in the helper files.
All the constants are defined with the same names as in the Win32 API header files. For more information about the system colors see the description of the GetSysColor API function in MSDN library.

COLOR_SCROLLBAR = 0
Scroll bars color
COLOR_BACKGROUND = 1
Background color - desktop background
COLOR_ACTIVECAPTION = 2
Active window caption background
COLOR_INACTIVECAPTION = 3
Inactive window caption background
COLOR_MENU = 4
Menu background color.
COLOR_WINDOW = 5
Window background color
COLOR_WINDOWFRAME = 6
Window border color
COLOR_MENUTEXT = 7
Color of the menu texts
COLOR_WINDOWTEXT = 8
Text color in the application windows 
COLOR_CAPTIONTEXT = 9
Color of the texts in the window captions and color of the signs used in the standard window buttons (min, max and so on)
COLOR_ACTIVEBORDER = 10
Border color of the active windows 
COLOR_INACTIVEBORDER = 11
Border color of the inactive windows
COLOR_APPWORKSPACE = 12
Background of the MDI frame windows  
COLOR_HIGHLIGHT = 13
Highlight color - selected menu items, list box selections and so on 
COLOR_HIGHLIGHTTEXT = 14
Text color for the highlighted items (see previous)
COLOR_BTNFACE = 15
Background color of the buttons.
COLOR_BTNSHADOW = 16
Color of the button shadow.
COLOR_GRAYTEXT = 17
Text color for the disabled items.
COLOR_BTNTEXT = 18
Button text color.
COLOR_INACTIVECAPTIONTEXT = 19
Text color for the captions of inactive windows.
COLOR_BTNHIGHLIGHT = 20
Highlight color for the buttons
COLOR_3DDKSHADOW = 21
3D effects shadow color
COLOR_3DLIGHT = 22
3D effects light color
COLOR_INFOTEXT = 23
Tool tip text color
COLOR_INFOBK = 24
Background color for the tool tips
COLOR_HOTLIGHT = 26
Track color. Highlighting tracked items such as links in the pages. (Not available on all the platforms)
COLOR_GRADIENTACTIVECAPTION = 27
Second color for the active window's caption.
COLOR_GRADIENTINACTIVECAPTION = 28
Second color for the captions of inactive windows

Some substitutions
COLOR_DESKTOP = COLOR_BACKGROUND;
COLOR_3DFACE = COLOR_BTNFACE;
COLOR_3DSHADOW = COLOR_BTNSHADOW;
COLOR_3DHIGHLIGHT = COLOR_BTNHIGHLIGHT;
COLOR_3DHILIGHT = COLOR_BTNHIGHLIGHT;
COLOR_BTNHILIGHT = COLOR_BTNHIGHLIGHT;

Note: Many of the system colors are actually substitutions but this depends on the the Windows version. Thus it is recommended to use the constants by meaning because future versions of the Windows may define different values for them. See MSDN library for more information.

Example: If you want to make your page view dialog-like you can do the following in the function that handles the BODY's onLoad event:
document.bgColor = external.sysColor( COLOR_BTNFACE );
document.fgColor =  external.sysColor( COLOR_BTNTEXT );

Applies to: external

See also: Helper libraries