Compartir a través de


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

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

Consulte también

Métodos AddPolygon

Recorte con una región

Crear y dibujar trazados

Creación de un degradado de trazado

Graphicspath

Paths

Point

Polígonos