setDialogSysColor

Syntax

int setDialogSysColor(int colorIndex)

Arguments

colorIndex
The code number of the display element color that will be applied to the dialog background

Display Elements

These values can also be found in the official [MSDN GetSysColor] docs.

COLOR_3DDKSHADOW Dark shadow for three-dimensional display elements.
COLOR_3DFACE Face color for three-dimensional display elements and for dialog box backgrounds.
COLOR_3DHIGHLIGHT Highlight color for three-dimensional display elements (for edges facing the light source.)
COLOR_3DHILIGHT Highlight color for three-dimensional display elements (for edges facing the light source.)
COLOR_3DLIGHT Light color for three-dimensional display elements (for edges facing the light source.)
COLOR_3DSHADOW Shadow color for three-dimensional display elements (for edges facing away from the light source).
COLOR_ACTIVEBORDER Active window border.
COLOR_ACTIVECAPTION Active window title bar.
COLOR_APPWORKSPACE Background color of multiple document interface (MDI) applications.
COLOR_BACKGROUND Desktop.
COLOR_BTNFACE Face color for three-dimensional display elements and for dialog box backgrounds.
COLOR_BTNHIGHLIGHT Highlight color for three-dimensional display elements (for edges facing the light source.)
COLOR_BTNHILIGHT Highlight color for three-dimensional display elements (for edges facing the light source.)
COLOR_BTNSHADOW Shadow color for three-dimensional display elements (for edges facing away from the light source).
COLOR_BTNTEXT Text on push buttons.
COLOR_CAPTIONTEXT Text in caption, size box, and scroll bar arrow box.
COLOR_DESKTOP Desktop.
COLOR_GRADIENTACTIVECAPTION Right side color in the color gradient of an active window's title bar.
COLOR_GRADIENTINACTIVECAPTION Right side color in the color gradient of an inactive window's title bar.
COLOR_GRAYTEXT Grayed (disabled) text.
COLOR_HIGHLIGHT Items selected in a control.
COLOR_HIGHLIGHTTEXT Text of items selected in a control.
COLOR_HOTLIGHT Color for a hyperlink or hot-tracked item.
COLOR_INACTIVEBORDER Inactive window border.
COLOR_INACTIVECAPTION Inactive window caption.
COLOR_INACTIVECAPTIONTEXT Color of text in an inactive caption.
COLOR_INFOBK Background color for tooltip controls.
COLOR_INFOTEXT Text color for tooltip controls.
COLOR_MENU Menu background.
COLOR_MENUHILIGHT The color used to highlight menu items when the menu appears as a flat menu. (Not supported on Windows 2000.)
COLOR_MENUBAR The background color for the menu bar when menus appear as flat menus. (Not supported on Windows 2000.)
COLOR_MENUTEXT Text in menus.
COLOR_SCROLLBAR Scroll bar gray area.
COLOR_WINDOW Window background.
COLOR_WINDOWFRAME Window frame.
COLOR_WINDOWTEXT Text in windows.

Return

Returns TRUE if the function succeeded.

Description

Changes the dialog background color to that of a specific Windows UI color, dependent on the user's UI theme and color scheme settings.

Example

%fml

OnFilterStart: {
  // Make dialog background light blue
  setDialogSysColor(COLOR_HIGHLIGHT);
  return false;
}

See Also

getSysColor, setCtlColor, setCtlSysColor, setDialogColor