Función PolyPolygon (wingdi.h)

Artículo
03/04/2024

La función PolyPolygon dibuja una serie de polígonos cerrados. Cada polígono se describe mediante el lápiz actual y se rellena mediante el modo de relleno de pincel y polígono actual. Los polígonos dibujados por esta función se pueden superponer.

Sintaxis

BOOL PolyPolygon(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const INT   *asz,
  [in] int         csz
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] apt

Puntero a una matriz de estructuras POINT que definen los vértices de los polígonos, en coordenadas lógicas. Los polígonos se especifican de forma consecutiva. Cada polígono se cierra automáticamente dibujando una línea del último vértice al primero. Cada vértice debe especificarse una vez.

[in] asz

Puntero a una matriz de enteros, cada uno de los cuales especifica el número de puntos del polígono correspondiente. Cada entero debe ser mayor o igual que 2.

[in] csz

Número total de polígonos.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Esta función no usa ni actualiza la posición actual.

Se omiten los puntos adicionales. Para dibujar los polígonos con más puntos, divida los datos en grupos, cada uno de los cuales tenga menos del número máximo de puntos y llame a la función para cada grupo de puntos. Tenga en cuenta que es mejor tener un polígono en solo uno de los grupos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll