Metodo PathGradientBrush::SetCenterColor (gdipluspath.h)

Articolo
02/29/2024

Il metodo PathGradientBrush::SetCenterColor imposta il colore centrale del pennello sfumato del percorso. Il colore centrale è il colore visualizzato nel punto centrale del pennello.

Sintassi

Status SetCenterColor(
  [in, ref] const Color & color
);

Parametri

[in, ref] color

Tipo: colore const

Riferimento a un oggetto Color che specifica il colore centrale.

Valore restituito

Tipo: Stato

Se il metodo ha esito positivo, restituisce Ok, che è un elemento dell'enumerazione Status .

Se il metodo ha esito negativo, restituisce uno degli altri elementi dell'enumerazione Status .

Commenti

Per impostazione predefinita, il punto centrale è il centro del percorso limite del pennello, ma è possibile impostare il punto centrale su qualsiasi posizione all'interno o all'esterno del percorso.

Esempio

Nell'esempio seguente viene creato un oggetto PathGradientBrush basato su un'ellisse. Il codice chiama il metodo PathGradientBrush::SetCenterColor dell'oggetto PathGradientBrush per impostare il colore centrale su blu. Il metodo PathGradientBrush::SetSurroundColors imposta il colore lungo l'intero limite su aqua. Il metodo FillRectangle Methods usa il pennello sfumatura del percorso per disegnare un rettangolo contenente l'ellisse.

VOID Example_SetCenter(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a path that consists of a single ellipse.
   GraphicsPath path;
   path.AddEllipse(0, 0, 200, 100);

   // Use the path to construct a brush.
   PathGradientBrush pthGrBrush(&path);

   // Set the color at the center of the path to blue.
   pthGrBrush.SetCenterColor(Color(255, 0, 0, 255));

   // Set the color along the entire boundary of the path to aqua.
   Color colors[] = {Color(255, 0, 255, 255)};
   INT count = 1;
   pthGrBrush.SetSurroundColors(colors, &count);

   graphics.FillRectangle(&pthGrBrush, 0, 0, 300, 300); 
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP, Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	gdipluspath.h (include Gdiplus.h)
Libreria	Gdiplus.lib
DLL	Gdiplus.dll