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 |