Funzione CreateDIBPatternBrushPt (wingdi.h)

Articolo
03/13/2024

La funzione CreateDIBPatternBrushPt crea un pennello logico con il modello specificato dalla bitmap indipendente dal dispositivo (DIB).

Sintassi

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

Parametri

[in] lpPackedDIB

Puntatore a un DIB compresso costituito da una struttura BITMAPINFO immediatamente seguita da una matrice di byte che definisce i pixel della bitmap.

[in] iUsage

Specifica se il membro bmiColors della struttura BITMAPINFO contiene una tabella di colori valida e, in tal caso, se le voci di questa tabella colori contengono valori rossi, verdi, blu o indici di tavolozza. Il parametro iUsage deve essere uno dei valori seguenti.

Valore	Significato
DIB_PAL_COLORS	Viene fornita una tabella colori e è costituita da una matrice di indici a 16 bit nella tavolozza logica del contesto del dispositivo in cui selezionare il pennello.
DIB_RGB_COLORS	Viene fornita una tabella dei colori e contiene valori RGB letterali.

Valore restituito

Se la funzione ha esito positivo, il valore restituito identifica un pennello logico.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Un pennello è una bitmap usata dal sistema per dipingere gli interni delle forme riempite.

Dopo che un'applicazione crea un pennello chiamando CreateDIBPatternBrushPt, può selezionare tale pennello in qualsiasi contesto del dispositivo chiamando la funzione SelectObject .

Quando non è più necessario il pennello, chiamare la funzione DeleteObject per eliminarla.

ICM: Nessun colore viene eseguito alla creazione del pennello. Tuttavia, la gestione dei colori viene eseguita quando il pennello viene selezionato in un contesto di dispositivo abilitato per ICM.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll