wingdi.h


SetSysColors

Cambia los colores de uno o más elementos de la pantalla. Estos elementos son las distintas partes de una ventana y la pantalla de Windows que aparecen en la pantalla del sistema.

Sintaxis

BOOL WINAPI SetSysColors(
    int cDspElements,             // número de elementos a cambiar
    CONST INT *lpnDspElements,    // dirección del array de elementos
    CONST COLORREF *lpdwRgbValues // dirección del array de valores RGB
   );

Parámetros:

cDspElements: especifica el número de elementos que contiene el array de apuntado por el parámetro lpnDspElements.

lpnDspElements: apunta a un array de enteros que especifican los elementos de pantalla a modificar. Para ver la lista de elementos de pantalla, ver la función GetSysColor.

lpdwRgbValues: puntero a un array de enteros largos sin signo (unsigned long int) que contiene lo nuevos valores de colores, rojo, verde y azul (RGB) para cada elemento de pantalla contenido en el array apuntado por el parámetro lpnDspElements.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener información más detallada sobre el error, llamar a la función GetLastError.

Observaciones

Esta función envía un mensaje WM_SYSCOLORCHANGE a todas las ventanas para informarles del cambio de color. Eso también obliga a Windows a repintar las zonas de pantalla afectadas de todas las ventanas visibles.

Los cambios afectan sólo a la sesión actual de Windows. Los nuevos colores no se conservan cuando Windows termina.