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

Artículo
02/29/2024

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

Sintaxis

Status AddPolygon(
  [in] const Point *points,
  [in] INT         count
);

Parámetros

[in] points

Tipo: const Point*

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

[in] count

Tipo: INT

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

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

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 Windows GDI+ 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 una ruta de acceso de objeto GraphicsPath, 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); 
 
   Point pts[] = {Point(20, 20),
                  Point(120, 20),
                  Point(120, 70)};

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

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

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