Método PathGradientBrush::SetCenterPoint(constPointF&) (gdipluspath.h)

Artículo
08/24/2023

El método PathGradientBrush::SetCenterPoint establece el punto central de este pincel de degradado de ruta de acceso. De forma predeterminada, el punto central está 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.

Sintaxis

Status SetCenterPoint(
  const PointF & point
);

Parámetros

point

Referencia a un objeto PointF que especifica 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 .

Observaciones

Ejemplos

En el ejemplo siguiente se crea un objeto PathGradientBrush basado en una elipse. El código establece el color central en azul y establece el color a lo largo del límite en aqua. De forma predeterminada, el punto central estaría en el centro de la elipse (100, 50), pero la llamada al método PathGradientBrush::SetCenterPoint establece el punto central en (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);
}