Función GetSysColorBrush (winuser.h)
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) |