Función CreateSolidBrush (wingdi.h)

Artículo
03/13/2024

La función CreateSolidBrush crea un pincel lógico que tiene el color sólido especificado.

Sintaxis

HBRUSH CreateSolidBrush(
  [in] COLORREF color
);

Parámetros

[in] color

Color del pincel. Para crear un valor de color COLORREF , use la macro RGB .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto identifica un pincel lógico.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Cuando ya no necesite el objeto HBRUSH , llame a la función DeleteObject para eliminarlo.

Un pincel sólido es un mapa de bits que el sistema utiliza para pintar los interiores de formas rellenas.

Una vez que una aplicación crea un pincel llamando a CreateSolidBrush, puede seleccionar ese pincel en cualquier contexto de dispositivo llamando a la función SelectObject .

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.

ICM: No se realiza ninguna administración de colores en la creación del pincel. Sin embargo, la administración de colores se realiza cuando el pincel se selecciona en un contexto de dispositivo habilitado para ICM.

Ejemplos

Para obtener un ejemplo, vea Creating Colored Pens and Brushes.

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	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll