Función CreatePatternBrush (wingdi.h)

Artículo
03/04/2024

La función CreatePatternBrush crea un pincel lógico con el patrón de mapa de bits especificado. El mapa de bits puede ser un mapa de bits de sección DIB, creado por la función CreateDIBSection , o puede ser un mapa de bits dependiente del dispositivo.

Sintaxis

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

Parámetros

[in] hbm

Identificador del mapa de bits que se va a usar para crear el pincel lógico.

Valor devuelto

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

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

Comentarios

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

Después de que una aplicación cree un pincel llamando a CreatePatternBrush, puede seleccionar ese pincel en cualquier contexto de dispositivo llamando a la función SelectObject .

Puede eliminar un pincel de patrón sin afectar al mapa de bits asociado mediante la función DeleteObject . Por lo tanto, puede usar este mapa de bits para crear cualquier número de pinceles de patrón.

Un pincel creado mediante un mapa de bits monocromo (1 bit por píxel) tiene los colores de texto y fondo del contexto del dispositivo al que se dibuja. Los píxeles representados por un bit se dibujan con el color de texto actual; Los píxeles representados por un bit se dibujan con el color de fondo actual.

ICM: No se realiza ningún color 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, consulte Uso de pinceles.

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