Funzione CreatePatternBrush (wingdi.h)

Articolo
03/04/2024

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