Método PathGradientBrush::GetCenterPoint(PointF*) (gdipluspath.h)

Artículo
03/16/2023

El método PathGradientBrush::GetCenterPoint obtiene el punto central de este pincel de degradado de ruta de acceso.

Sintaxis

Status GetCenterPoint(
  PointF *point
);

Parámetros

point

Puntero a un objeto PointF que recibe el punto central.

Valor devuelto

Type:Status

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

De forma predeterminada, el punto central de un objeto PathGradientBrush se encuentra en el centroide de la ruta de acceso de límite del pincel, pero puede establecer el punto central en cualquier ubicación, dentro o fuera de la ruta de acceso, llamando al método SetCenterPoint del objeto PathGradientBrush .

Ejemplos

En el ejemplo siguiente se muestran varios métodos de la clase PathGradientBrush , incluido PathGradientBrush::GetCenterPoint y PathGradientBrush::SetCenterColor. El código crea un objeto PathGradientBrush y, a continuación, establece el color central y el color del límite del pincel. El código llama al método PathGradientBrush::GetCenterPoint para determinar el punto central del degradado de ruta de acceso y, a continuación, dibuja una línea desde el origen hasta ese punto central.

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