Windows Mobile 6.5
A version of this page is also available for

This function sets the colors for one or more display elements.

BOOL WINAPI SetSysColors( 
  int cElements, 
  CONST INT* lpaElements, 
  CONST COLORREF* lpaRgbValues


Specifies the number of display elements in the array pointed to by the lpaElements parameter.


Long pointer to an array of integers that specify the display elements to be changed. For a list of display elements, see GetSysColor.


Long pointer to an array of unsigned long integers that contains the new red, green, blue (RGB) color value for each display element in the array pointed to by the lpaElements parameter.

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

The SetSysColors function sends a WM_SYSCOLORCHANGE message to all windows to inform them of the change in color. It also directs the system to repaint the affected portions of all currently visible windows.

The SetSysColors function changes the current session only. The new colors are not saved when the system terminates.

Windows Embedded CEWindows CE 2.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions