winuser.h


GetSysColor

Recupera el color actualmente asignado para un elemento de pantalla especificado. Los elementos de pantalla son las partes de una ventana y cualquier cosa que aparece en la pantalla del sistema, normalmente el monitor.

Sintaxis

DWORD GetSysColor(
    int nIndex   // elemento de pantalla
   );

Parámetros:

nIndex: especifica el elemento de pantalla cuyo color debe ser recuperado. Este parámetro debe ser uno de los siguientes valores:

Valor Significado
COLOR_3DDKSHADOW Sólo Windows 95: color de sombra oscura para elementos de pantalla 3D.
COLOR_3DFACE Sólo Windows 95: color para elementos de pantalla 3D.
COLOR_3DHILIGHT Sólo Windows 95: color brillante para elementos de pantalla 3D (bordes del lado del que proviene la luz).
COLOR_3DLIGHT Sólo Windows 95: color claro para elementos de pantalla 3D (bordes del lado del que proviene la luz).
COLOR_3DSHADOW Sólo Windows 95: color de sombra para elementos de pantalla 3D (bordes del lado contrario del que proviene la luz).
COLOR_ACTIVEBORDER Borde activo de ventana.
COLOR_ACTIVECAPTION Barra de título de ventana activa.
COLOR_APPWORKSPACE Color de fondo para aplicaciones multidocumento (MDI).
COLOR_BACKGROUND Escritorio.
COLOR_BTNFACE Sólo Windows NT: sombreado de botones corrientes (push buttons).
COLOR_BTNHILIGHT Sólo Windows 95: color brillante para botones (el mismo que COLOR_3DHILIGHT).
COLOR_BTNSHADOW Color del sombreado en botones corrientes (push buttons).
COLOR_BTNTEXT Texto en botones corrientes (push buttons).
COLOR_CAPTIONTEXT Texto en barra de título, caja de tamaño y en caja de flechas en barras de desplazamiento.
COLOR_GRAYTEXT Texto difuminado, deshabilitado. Este color se pone a 0 si el manejador del dispositivo gráfico actual no soporta un color gris sólido.
COLOR_HIGHLIGHT Elementos seleccionados en un control.
COLOR_HIGHLIGHTTEXT Texto de los elementos seleccionados en un control.
COLOR_INACTIVEBORDER Color de borde inactivo de una ventana.
COLOR_INACTIVECAPTION Color de la barra de título en una ventana inactiva.
COLOR_INACTIVECAPTIONTEXT Color del texto en una barra de título inactiva.
COLOR_INFOBK Sólo Windows 95: color de fondo para controles tooltip.
COLOR_INFOTEXT Sólo Windows 95: color de texto para controles tooltip.
COLOR_MENU Color de fondo de menús.
COLOR_MENUTEXT Sólo Windows NT: texto en menús.
COLOR_SCROLLBAR Color del área gris en barras de desplazamiento.
COLOR_WINDOW Color de fondo de ventanas.
COLOR_WINDOWFRAME Color de marco de ventanas.
COLOR_WINDOWTEXT Color del texto en ventanas.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el color RGB, (rojo, verde y azul) que especifica el color del elemento pedido.

Observaciones

Los colores de sistema para dispositivos monocromo se interpretan normalmente como escalas de grises.

Para modificar los colores del sistema se usa la función SetSysColors.