Older Newer
Thu, 02 Sep 2021 06:55:47 . . . . SyneRyder [Initial function definition]


Changes by last author:

Added:
= 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 ==

<code>

%fml

OnFilterStart: {

// Make dialog background light blue

setDialogSysColor(COLOR_HIGHLIGHT);

return false;

}

</code>

== See Also ==

getSysColor, setCtlColor, setCtlSysColor, setDialogColor