Función CreateDIBPatternBrushPt (wingdi.h)

Artículo
03/04/2024

La función CreateDIBPatternBrushPt crea un pincel lógico que tiene el patrón especificado por el mapa de bits independiente del dispositivo (DIB).

Sintaxis

HBRUSH CreateDIBPatternBrushPt(
  [in] const VOID *lpPackedDIB,
  [in] UINT       iUsage
);

Parámetros

[in] lpPackedDIB

Puntero a una DIB empaquetada que consta de una estructura BITMAPINFO inmediatamente seguida de una matriz de bytes que define los píxeles del mapa de bits.

[in] iUsage

Especifica si el miembro rgbColors de la estructura BITMAPINFO contiene una tabla de colores válida y, si es así, si las entradas de esta tabla de colores contienen valores explícitos de color rojo, verde, azul (RGB) o índices de paleta. El parámetro iUsage debe ser uno de los valores siguientes.

Valor	Significado
DIB_PAL_COLORS	Se proporciona una tabla de colores y consta de una matriz de índices de 16 bits en la paleta lógica del contexto del dispositivo en el que se va a seleccionar el pincel.
DIB_RGB_COLORS	Se proporciona una tabla de colores y contiene valores RGB literales.

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 es un mapa de bits que el sistema utiliza para pintar los interiores de formas rellenadas.

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

Cuando ya no necesite el pincel, llame a la función DeleteObject para eliminarla.

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.

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