Funzione CreatePatternBrush (wingdi.h)

La funzione CreatePatternBrush crea un pennello logico con il modello bitmap specificato. La bitmap può essere una bitmap di sezione DIB creata dalla funzione CreateDIBSection oppure può essere una bitmap dipendente dal dispositivo.

Sintassi

HBRUSH CreatePatternBrush(
  [in] HBITMAP hbm
);

Parametri

[in] hbm

Handle per la bitmap da usare per creare il pennello logico.

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 modello è una bitmap usata dal sistema per disegnare gli interni delle forme riempite.

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

È possibile eliminare un pennello modello senza influire sulla bitmap associata usando la funzione DeleteObject . È quindi possibile usare questa bitmap per creare un numero qualsiasi di pennelli di modello.

Un pennello creato usando una bitmap monocromatica (1 bit per pixel) ha i colori di testo e sfondo del contesto del dispositivo a cui viene disegnato. I pixel rappresentati da un bit vengono disegnati con il colore del testo corrente; i pixel rappresentati da un bit vengono disegnati con il colore di sfondo corrente.

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.

Esempio

Per un esempio, vedere Uso di pennelli.

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

Funzioni pennello

Panoramica dei pennelli

CreateBitmap

CreateBitmapIndirect

CreateCompatibleBitmap

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateDIBSection

CreateHatchBrush

DeleteObject

GetBrushOrgEx

LoadBitmap

SelectObject

SetBrushOrgEx