Función CreateDIBPatternBrush (wingdi.h)

Artículo
08/27/2023

La función CreateDIBPatternBrush crea un pincel lógico que tiene el patrón especificado por el mapa de bits independiente del dispositivo (DIB) especificado. Posteriormente, el pincel se puede seleccionar en cualquier contexto de dispositivo asociado a un dispositivo que admita operaciones de trama.

Nota Esta función solo se proporciona por compatibilidad con versiones de 16 bits de Windows. Las aplicaciones deben usar la función CreateDIBPatternBrushPt .

Sintaxis

HBRUSH CreateDIBPatternBrush(
  [in] HGLOBAL h,
  [in] UINT    iUsage
);

Parámetros

[in] h

Identificador de un objeto de memoria global que contiene una DIB empaquetada, que consta de una estructura BITMAPINFO seguida inmediatamente de una matriz de bytes que define los píxeles del mapa de bits.

[in] iUsage

Especifica si el miembro indexColors de la estructura BITMAPINFO se inicializa y, si es así, si este miembro contiene valores explícitos rojo, verde, azul (RGB) o índices en una paleta lógica. El parámetro fuColorSpec 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 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 una aplicación selecciona un pincel de patrón DIB de dos colores en un contexto de dispositivo monocromático, el sistema no reconoce los colores especificados en la DIB; en su lugar, muestra el pincel de patrón mediante el fondo actual y los colores de primer plano del contexto del dispositivo. Los píxeles asignados al primer color de la DIB (desplazamiento 0 en la tabla de colores DIB) se muestran utilizando el color de primer plano; Los píxeles asignados al segundo color (desplazamiento 1 de la tabla de colores) se muestran mediante el color de fondo.

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