Función GetSysColorBrush (winuser.h)

Artículo
03/15/2023

La función GetSysColorBrush recupera un identificador que identifica un pincel lógico que corresponde al índice de color especificado.

Sintaxis

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

Parámetros

[in] nIndex

Índice de color. Este valor corresponde al color utilizado para pintar uno de los elementos de la ventana. Consulte GetSysColor para obtener valores de índice de color del sistema.

Valor devuelto

El valor devuelto identifica un pincel lógico si la plataforma actual admite el parámetro nIndex . De lo contrario, devuelve NULL.

Comentarios

Un pincel es un mapa de bits que el sistema utiliza para pintar los interiores de formas rellenas. Una aplicación puede recuperar los colores actuales del sistema llamando a la función GetSysColor . Una aplicación puede establecer los colores actuales del sistema llamando a la función SetSysColors .

Una aplicación no debe registrar una clase de ventana para una ventana mediante un pincel del sistema. Para registrar una clase de ventana con un color del sistema, consulte la documentación del miembro hbrBackground de las estructuras WNDCLASS o WNDCLASSEX .

Los pinceles de color del sistema realizan un seguimiento de los cambios en los colores del sistema. En otras palabras, cuando el usuario cambia un color del sistema, el pincel de color del sistema asociado cambia automáticamente al nuevo color.

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.

Los pinceles de color del sistema son propiedad del sistema, por lo que no es necesario destruirlos. Aunque no es necesario eliminar el pincel lógico que Devuelve GetSysColorBrush , no se produce ningún daño llamando a DeleteObject.

Requisitos

Requisito	Value
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
Conjunto de API	ext-ms-win-ntuser-gui-l1-1-1 (introducido en Windows 8.1)