Función CreateSolidBrush (wingdi.h)

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

Consulte también

Funciones brush

Información general sobre los pinceles

COLORREF

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateHatchBrush

CreatePatternBrush

DeleteObject

GetSysColorBrush

RGB

SelectObject