Metodo PathGradientBrush::GetCenterPoint(PointF*) (gdipluspath.h)

Articolo
07/16/2024

Il metodo PathGradientBrush::GetCenterPoint ottiene il punto centrale del pennello sfumato del percorso.

Sintassi

Status GetCenterPoint(
  PointF *point
);

Parametri

point

Puntatore a un oggetto PointF che riceve il punto centrale.

Valore restituito

Tipo di :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.

Osservazioni

Per impostazione predefinita, il punto centrale di un oggetto PathGradientBrush si trova al centro del percorso limite del pennello, ma è possibile impostare il punto centrale su qualsiasi posizione, all'interno o all'esterno del percorso, chiamando il metodo SetCenterPoint dell'oggetto PathGradientBrush.

Esempi

Nell'esempio seguente vengono illustrati diversi metodi della classe PathGradientBrush, tra cui PathGradientBrush::GetCenterPoint e PathGradientBrush::SetCenterColor. Il codice crea un oggetto PathGradientBrush e quindi imposta il colore centrale e il colore del limite del pennello. Il codice chiama il metodo PathGradientBrush::GetCenterPoint per determinare il punto centrale della sfumatura del percorso e quindi disegna una linea dall'origine a quel punto centrale.

VOID Example_GetCenterPoint(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);

   // Fill the ellipse with the path gradient brush.
   graphics.FillEllipse(&pthGrBrush, 0, 0, 200, 100);

   // Obtain information about the path gradient brush.
   PointF centerPoint;
   pthGrBrush.GetCenterPoint(&centerPoint);

   // Draw a line from the origin to the center of the ellipse.
   Pen pen(Color(255, 0, 255, 0));
   graphics.DrawLine(&pen, PointF(0, 0), centerPoint);  
}