Método GraphicsPath::AddPolygon(constPointF*,INT) (gdipluspath.h)

Artículo
07/16/2024

El método GraphicsPath::AddPolygon agrega un polígono a esta ruta de acceso.

Sintaxis

Status AddPolygon(
  const PointF *points,
  INT          count
);

Parámetros

points

Puntero a una matriz de puntos que especifica los vértices del polígono.

count

Entero que especifica el número de elementos de la matriz de puntos.

Valor devuelto

Tipo de : estado de

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

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

Observaciones

El método GraphicsPath::AddPolygon es similar al método AddLines. La diferencia es que un polígono es una figura intrínsecamente cerrada, pero una secuencia de líneas no es una figura cerrada a menos que llame a GraphicsPath::CloseFigure. Cuando GDI+ de Windows representa una ruta de acceso, cada polígono de esa ruta se cierra; es decir, el último vértice del polígono está conectado al primer vértice mediante una línea recta.

Ejemplos

En el ejemplo siguiente se crea un GraphicsPath ruta de acceso del objeto, se agrega un polígono a la ruta de acceso y, a continuación, se dibuja la ruta de acceso.

VOID Example_AddPolygon(HDC hdc)
{
   Graphics graphics(hdc);

   PointF pts[] = {PointF(20.0f, 20.0f),
                   PointF(120.0f, 20.0f),
                   PointF(120.0f, 70.0f)};

   GraphicsPath path;
   path.AddPolygon(pts, 3);

   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}