Funzione CreateDIBPatternBrush (wingdi.h)

Articolo
03/13/2024

La funzione CreateDIBPatternBrush crea un pennello logico con il modello specificato dalla bitmap indipendente dal dispositivo specificata. Il pennello può successivamente essere selezionato in qualsiasi contesto di dispositivo associato a un dispositivo che supporta le operazioni raster.

Nota Questa funzione viene fornita solo per la compatibilità con le versioni a 16 bit di Windows. Le applicazioni devono usare la funzione CreateDIBPatternBrushPt .

Sintassi

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

Parametri

[in] h

Handle per un oggetto memoria globale contenente 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 viene inizializzato e, in tal caso, se il membro contiene valori espliciti rosso, verde, blu (RGB) o indici in una tavolozza logica. Il parametro fuColorSpec deve essere uno dei valori seguenti.

Valore	Significato
DIB_PAL_COLORS	Viene fornita una tabella dei colori ed è costituita da una matrice di indici a 16 bit nella tavolozza logica del contesto di dispositivo in cui deve essere selezionato 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

Quando un'applicazione seleziona un pennello con motivo DIB a due colori in un contesto di dispositivo monocromatico, il sistema non riconosce i colori specificati nel DIB; visualizza invece il pennello del motivo usando lo sfondo corrente e i colori di primo piano del contesto del dispositivo. I pixel mappati al primo colore del DIB (offset 0 nella tabella dei colori DIB) vengono visualizzati utilizzando il colore di primo piano; i pixel mappati al secondo colore (offset 1 nella tabella dei colori) vengono visualizzati usando il colore di sfondo.

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

ICM: Al momento della creazione del pennello non viene eseguito alcun colore. 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