Editing setCtlSysColor - FilterMeisterWiki

When saving, enter the following:

 _     ##   ##   TT  TT    ####            
( )    ##   ##   TT  TT   ##  ##           
| |    ##   ##   TT  TT  ##        #####   
| |  _  #####    TT  TT  ##        ##  ##  
| |_( )  ###     TT  TT  ##        #####   
(____/'  ###      TTTT    ##  ##   ##  ##  
         ###       TT      ####    ##  ##  
                                   #####

Visit Preferences to set your user name

= setCtlSysColor =

== Syntax ==
{{int setCtlSysColor(int n, int colorIndex)}}

== Arguments ==
:'''n'''
::The number of the control that will have its color changed
:'''colorIndex'''
::The display element color code that will be applied to the control

== Display Elements ==
These values can also be found in the official [https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-getsyscolor 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 color of a control to a specific Windows UI color, dependent on the user's UI theme and color scheme settings.

== Example ==
<code>
%fml

ctl[0]: SCROLLBAR

OnFilterStart: {
  // Make scrollbar light blue
  setCtlSysColor(0, COLOR_HIGHLIGHT);
  return false;
}
</code>

== See Also ==
((getSysColor)), ((setCtlColor)), ((setDialogColor))

Summary of change:
Add document to category: