Funzione CreateDIBPatternBrushPt (wingdi.h)

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

Vedi anche

BITMAPINFO

Funzioni pennello

Panoramica dei pennelli

CreateDIBPatternBrush

CreateHatchBrush

CreatePatternBrush

CreateSolidBrush

DeleteObject

GetBrushOrgEx

SelectObject

SetBrushOrgEx