Compartir a través de


Función CreateDIBPatternBrushPt (wingdi.h)

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

Consulte también

BITMAPINFO

Funciones de pincel

Información general sobre los pinceles

CreateDIBPatternBrush

CreateHatchBrush

CreatePatternBrush

CreateSolidBrush

DeleteObject

GetBrushOrgEx

SelectObject

SetBrushOrgEx