Funzione CreateSolidBrush (wingdi.h)
La funzione CreateSolidBrush crea un pennello logico con il colore a tinta unita specificato.
Sintassi
HBRUSH CreateSolidBrush(
[in] COLORREF color
);
Parametri
[in] color
Colore del pennello. Per creare un valore di colore COLORREF , usare la macro RGB .
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 non è più necessario l'oggetto HBRUSH , chiamare la funzione DeleteObject per eliminarla.
Un pennello solido è una bitmap usata dal sistema per disegnare gli interni delle forme riempite.
Dopo che un'applicazione crea un pennello chiamando CreateSolidBrush, può selezionare tale pennello in qualsiasi contesto del dispositivo chiamando la funzione SelectObject .
Per disegnare con un pennello di colore di sistema, un'applicazione deve usare GetSysColorBrush (nIndex) invece di CreateSolidBrush(GetSysColor(nIndex)), perché GetSysColorBrush restituisce un pennello memorizzato nella cache anziché allocare uno nuovo.
ICM: Nessuna gestione dei colori viene eseguita 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 Creazione di penne colorate e 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 |