Funzione CreateSolidBrush (wingdi.h)

Articolo
03/13/2024

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