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

Artículo
02/27/2024

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

Sintaxis

Status GetCenterPoint(
  [out] Point *point
);

Parámetros

[out] point

Tipo: Punto*

Puntero a un objeto Point que recibe el punto central.

Valor devuelto

Tipo: Estado

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 pincel de 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.
   Point  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, Point(0, 0), centerPoint);
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdipluspath.h (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll