Función GetSysColor (winuser.h)

  • Artículo

Recupera el color actual del elemento de presentación especificado. Los elementos de visualización son las partes de una ventana y la pantalla que aparecen en la pantalla de pantalla del sistema.

Sintaxis

DWORD GetSysColor(
  [in] int nIndex
);

Parámetros

[in] nIndex

Tipo: int

Elemento de presentación cuyo color se va a recuperar. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
COLOR_3DDKSHADOW
21
 Sombra oscura para los elementos de visualización tridimensional.

Windows 10 o posterior: Este valor no se admite.
COLOR_3DFACE
15
 Color de cara para elementos de visualización tridimensionales y para fondos de cuadro de diálogo.
COLOR_3DHIGHLIGHT
20
 Color resaltado para elementos de visualización tridimensionales (para bordes orientados a la fuente de luz).

Windows 10 o posterior: Este valor no se admite.
COLOR_3DHILIGHT
20
 Color resaltado para elementos de visualización tridimensionales (para bordes orientados a la fuente de luz).

Windows 10 o posterior: Este valor no se admite.
COLOR_3DLIGHT
22
 Color claro para elementos de visualización tridimensionales (para bordes orientados a la fuente de luz).

Windows 10 o posterior: Este valor no se admite.
COLOR_3DSHADOW
16
 Color de sombra para elementos de visualización tridimensionales (para bordes que se alejan de la fuente de luz).

Windows 10 o posterior: Este valor no se admite.
COLOR_ACTIVEBORDER
10
 Borde de ventana activo.

Windows 10 o posterior: Este valor no se admite.
COLOR_ACTIVECAPTION
2
 Barra de título de ventana activa.

El color de primer plano asociado es COLOR_CAPTIONTEXT.

Especifica el color del lado izquierdo en el degradado de color de la barra de título de una ventana activa si el efecto degradado está habilitado.

Windows 10 o posterior: Este valor no se admite.
COLOR_APPWORKSPACE
12
 Color de fondo de varias aplicaciones de interfaz de documento (MDI).

Windows 10 o posterior: Este valor no se admite.
COLOR_BACKGROUND
1
 Escritorio.

Windows 10 o posterior: Este valor no se admite.
COLOR_BTNFACE
15
 Color de cara para elementos de visualización tridimensionales y para fondos de cuadro de diálogo. El color de primer plano asociado es COLOR_BTNTEXT.

Windows 10 o posterior: Este valor no se admite.
COLOR_BTNHIGHLIGHT
20
 Color resaltado para elementos de visualización tridimensionales (para bordes orientados a la fuente de luz).

Windows 10 o posterior: Este valor no se admite.
COLOR_BTNHILIGHT
20
 Color resaltado para elementos de visualización tridimensionales (para bordes orientados a la fuente de luz).

Windows 10 o posterior: Este valor no se admite.
COLOR_BTNSHADOW
16
 Color de sombra para elementos de visualización tridimensionales (para bordes que se alejan de la fuente de luz).

Windows 10 o posterior: Este valor no se admite.
COLOR_BTNTEXT
18
 Texto en los botones de inserción. El color de fondo asociado es COLOR_BTNFACE.
COLOR_CAPTIONTEXT
9
 Texto en subtítulo, cuadro de tamaño y cuadro de flecha de barra de desplazamiento. El color de fondo asociado es COLOR_ACTIVECAPTION.

Windows 10 o posterior: Este valor no se admite.
COLOR_DESKTOP
1
 Escritorio.

Windows 10 o posterior: Este valor no se admite.
COLOR_GRADIENTACTIVECAPTION
27
 Color del lado derecho en el degradado de color de la barra de título de una ventana activa. COLOR_ACTIVECAPTION especifica el color del lado izquierdo. Use SPI_GETGRADIENTCAPTIONS con la función SystemParametersInfo para determinar si el efecto degradado está habilitado.

Windows 10 o posterior: Este valor no se admite.
COLOR_GRADIENTINACTIVECAPTION
28
 Color del lado derecho en el degradado de color de la barra de título de una ventana inactiva. COLOR_INACTIVECAPTION especifica el color del lado izquierdo.

Windows 10 o posterior: Este valor no se admite.
COLOR_GRAYTEXT
17
 Texto atenuado (deshabilitado). Este color se establece en 0 si el controlador de pantalla actual no admite un color gris sólido.
COLOR_HIGHLIGHT
13
 Elementos seleccionados en un control . El color de primer plano asociado es COLOR_HIGHLIGHTTEXT.
COLOR_HIGHLIGHTTEXT
14
 Texto de los elementos seleccionados en un control . El color de fondo asociado es COLOR_HIGHLIGHT.
COLOR_HOTLIGHT
26
 Color de un hipervínculo o elemento de seguimiento activo. El color de fondo asociado es COLOR_WINDOW.
COLOR_INACTIVEBORDER
11
 Borde de ventana inactivo.

Windows 10 o superior: Este valor no se admite.
COLOR_INACTIVECAPTION
3
 Subtítulo de ventana inactiva.

El color de primer plano asociado es COLOR_INACTIVECAPTIONTEXT.

Especifica el color izquierdo en el degradado de color de la barra de título de una ventana inactiva si el efecto de degradado está habilitado.

Windows 10 o superior: Este valor no se admite.
COLOR_INACTIVECAPTIONTEXT
19
 Color del texto en un subtítulo inactivo. El color de fondo asociado es COLOR_INACTIVECAPTION.

Windows 10 o superior: Este valor no se admite.
COLOR_INFOBK
24
 Color de fondo para controles de información sobre herramientas. El color de primer plano asociado es COLOR_INFOTEXT.

Windows 10 o superior: Este valor no se admite.
COLOR_INFOTEXT
23
 Color de texto para controles de información sobre herramientas. El color de fondo asociado es COLOR_INFOBK.

Windows 10 o superior: Este valor no se admite.
COLOR_MENU
4
 Fondo del menú. El color de primer plano asociado es COLOR_MENUTEXT.

Windows 10 o superior: Este valor no se admite.
COLOR_MENUHILIGHT
29
 Color usado para resaltar elementos de menú cuando el menú aparece como un menú plano (vea SystemParametersInfo). El elemento de menú resaltado se describe con COLOR_HIGHLIGHT.

Windows 2000, Windows 10 o superior: Este valor no se admite.
COLOR_MENUBAR
30
 Color de fondo de la barra de menús cuando los menús aparecen como menús planos (vea SystemParametersInfo). Sin embargo, COLOR_MENU continúa especificando el color de fondo del menú emergente.

Windows 2000, Windows 10 o superior: Este valor no se admite.
COLOR_MENUTEXT
7
 Texto en menús. El color de fondo asociado es COLOR_MENU.

Windows 10 o superior: Este valor no se admite.
COLOR_SCROLLBAR
0
 Área gris de la barra de desplazamiento.

Windows 10 o superior: Este valor no se admite.
COLOR_WINDOW
5
 Fondo de la ventana. Los colores de primer plano asociados son COLOR_WINDOWTEXT y COLOR_HOTLITE.
COLOR_WINDOWFRAME
6
 Marco de ventana.

Windows 10 o superior: Este valor no se admite.
COLOR_WINDOWTEXT
8
 Texto en ventanas. El color de fondo asociado es COLOR_WINDOW.

Valor devuelto

Tipo: DWORD

La función devuelve el valor de color rojo, verde y azul (RGB) del elemento especificado.

Si el parámetro nIndex está fuera del intervalo, el valor devuelto es cero. Dado que cero también es un valor RGB válido, no puede usar GetSysColor para determinar si la plataforma actual admite un color del sistema. En su lugar, use la función GetSysColorBrush , que devuelve NULL si no se admite el color.

Comentarios

Para mostrar el componente del valor RGB, use las macros GetRValue, GetGValue y GetBValue .

Los colores del sistema para las pantallas monocromáticas suelen interpretarse como tonos de gris.

Para pintar con un pincel de color del sistema, una aplicación debe usar GetSysColorBrush(nIndex), en lugar de CreateSolidBrush(GetSysColor(nIndex)), porque GetSysColorBrush devuelve un pincel almacenado en caché, en lugar de asignar uno nuevo.

El color es un elemento visual importante de la mayoría de las interfaces de usuario. Para obtener instrucciones sobre el uso del color en las aplicaciones, consulta Color - Win32 y Color en Windows 11.

Colores del sistema de Windows 10/11

En esta tabla se muestran los valores admitidos en Windows 10 y Windows 11 con valores de color del tema de contraste acuático Windows 11.

Muestra de color Descripción

COLOR_WINDOWFondo de páginas, paneles, ventanas emergentes y ventanas.

Emparejar con COLOR_WINDOWTEXT

COLOR_WINDOWTEXTEncabezados, copia del cuerpo, listas, texto de marcador de posición, bordes de aplicación y ventana, cualquier interfaz de usuario con la que no se pueda interactuar.

Emparejar con COLOR_WINDOW

COLOR_HOTLIGHTHipervínculos.

Emparejar con COLOR_WINDOW

COLOR_GRAYTEXTInterfaz de usuario

inactiva (deshabilitada).Emparejar con COLOR_WINDOW

COLOR_HIGHLIGHTTEXTColor de primer plano para texto o interfaz de usuario que está seleccionado, interactúa con (mantener el puntero, presionar) o en curso.

Emparejar con COLOR_HIGHLIGHT

COLOR_HIGHLIGHTColor de fondo o énfasis para la interfaz de usuario que está seleccionada, interactúa con (mantener el puntero, presionar) o en curso.

Emparejar con COLOR_HIGHLIGHTTEXT

COLOR_BTNTEXTColor de primer plano para los botones y cualquier interfaz de usuario con la que se pueda interactuar.

Emparejar con COLOR_3DFACE

COLOR_3DFACEColor de fondo para botones y cualquier interfaz de usuario con la que se pueda interactuar.

Emparejar con COLOR_BTNTEXT

Estas imágenes muestran cómo aparecen los colores cuando se usan en un conjunto de fondo en COLOR_WINDOW.

Ejemplo Valores
Ventana con texto mediante el color del texto de la ventana. COLOR_WINDOWTEXT
Ventana con texto de hipervínculo mediante el color de luz activa. COLOR_HOTLIGHT
Ventana con texto inactivo mediante el color gris del texto. COLOR_GRAYTEXT
Ventana con texto con el color de texto resaltado en el color de resaltado. COLOR_HIGHLIGHTTEXT + HIGHLIGHT
Ventana con un botón con el color de la cara 3d y el texto del botón mediante el color del texto del botón. COLOR_BTNTEXT + COLOR_3DFACE

Ejemplos

Para obtener un ejemplo, vea SetSysColors.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll

Consulte también

CreateSolidBrush

GetSysColorBrush

SetSysColors

SystemParametersInfo