PathGradientBrush::SetCenterPoint(constPointF&) -Methode (gdipluspath.h)

Artikel
07/16/2024

Die PathGradientBrush::SetCenterPoint-Methode legt den Mittelpunkt dieses Pfadverlaufpinsels fest. Der Mittelpunkt befindet sich standardmäßig am Mittelpunkt des Begrenzungspfads des Pinsels, Sie können den Mittelpunkt jedoch auf eine beliebige Position innerhalb oder außerhalb des Pfads festlegen.

Syntax

Status SetCenterPoint(
  const PointF & point
);

Parameter

point

Verweisen auf ein PointF--Objekt, das den Mittelpunkt angibt.

Rückgabewert

Typ:Status

Wenn die Methode erfolgreich ist, wird Ok zurückgegeben, bei dem es sich um ein Element der Status Enumeration handelt.

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status Enumeration zurückgegeben.

Bemerkungen

Beispiele

Im folgenden Beispiel wird ein PathGradientBrush--Objekt erstellt, das auf einer Ellipse basiert. Der Code legt die Mittlere Farbe auf Blau fest und legt die Farbe entlang der Grenze auf Aqua fest. Standardmäßig befindet sich der Mittelpunkt in der Mitte der Ellipse (100, 50), aber der Aufruf des PathGradientBrush::SetCenterPoint-Methode legt den Mittelpunkt auf (180,5, 50,0).

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 center point.
   pthGrBrush.SetCenterPoint(PointF(180.5f, 50.0f));

   // 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);
}