En esta página

QPolygon Class

La clase QPolygon proporciona una lista de puntos con precisión entera. Más información...

Encabezado: #include <QPolygon>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QList

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QPolygon()
QPolygon(const QList<QPoint> &points)
QPolygon(const QRect &rectangle, bool closed = false)
QRect boundingRect() const
bool containsPoint(const QPoint &point, Qt::FillRule fillRule) const
QPolygon intersected(const QPolygon &r) const
bool intersects(const QPolygon &p) const
void point(int index, int *x, int *y) const
QPoint point(int index) const
void putPoints(int index, int nPoints, int firstx, int firsty, ...)
void putPoints(int index, int nPoints, const QPolygon &fromPolygon, int fromIndex = 0)
void setPoint(int index, int x, int y)
void setPoint(int index, const QPoint &point)
void setPoints(int nPoints, const int *points)
void setPoints(int nPoints, int firstx, int firsty, ...)
QPolygon subtracted(const QPolygon &r) const
void swap(QPolygon &other)
(since 6.4) QPolygonF toPolygonF() const
void translate(int dx, int dy)
void translate(const QPoint &offset)
QPolygon translated(int dx, int dy) const
QPolygon translated(const QPoint &offset) const
QPolygon united(const QPolygon &r) const
operator QVariant() const
QDataStream &operator<<(QDataStream &stream, const QPolygon &polygon)
QDataStream &operator>>(QDataStream &stream, QPolygon &polygon)

Descripción detallada

Un objeto QPolygon es un « QList » <QPoint>. La forma más sencilla de añadir puntos a un QPolygon es utilizar el operador de streaming de « QList », tal y como se ilustra a continuación:

QPolygon polygon;
polygon << QPoint(10, 20) << QPoint(20, 30);

Además de las funciones que proporciona QList, QPolygon ofrece algunas funciones específicas para puntos.

Cada punto de un polígono se puede recuperar pasando su índice a la función point(). Para rellenar el polígono, QPolygon proporciona la función ` setPoint()` para establecer el punto en un índice determinado, la función ` setPoints()` para establecer todos los puntos del polígono (redimensionándolo al número de puntos dado) y la función ` putPoints()`, que copia un número determinado de puntos en el polígono a partir de un índice especificado (redimensionando el polígono si es necesario).

QPolygon proporciona las funciones ` boundingRect()` y ` translate()` para operaciones geométricas. Utilice la función ` QTransform::map()` para transformaciones más generales de QPolygons.

La clase QPolygon se comparte de forma implícita.

Véase también QList, QPolygonF y QLine.

Documentación de las funciones miembro

[constexpr noexcept default] QPolygon::QPolygon()

Crea un polígono sin puntos.

Véase también QList::isEmpty().

QPolygon::QPolygon(const QList<QPoint> &points)

Crea un polígono que contiene el points especificado.

Véase también setPoints().

QPolygon::QPolygon(const QRect &rectangle, bool closed = false)

Crea un polígono a partir del rectángulo dado rectangle. Si closed es falso, el polígono solo contiene los cuatro vértices del rectángulo ordenados en el sentido de las agujas del reloj; en caso contrario, el quinto vértice del polígono se establece en rectangle.topLeft().

Ten en cuenta que la esquina inferior derecha del rectángulo se encuentra en (rectangle.x() + rectangle.width(), rectangle.y() + rectangle.height()).

Véase también setPoints().

QRect QPolygon::boundingRect() const

Devuelve el rectángulo delimitador del polígono, o bien QRect(0, 0, 0, 0) si el polígono está vacío.

Véase también QList::isEmpty().

bool QPolygon::containsPoint(const QPoint &point, Qt::FillRule fillRule) const

Devuelve ` true ` si el ` point ` dado se encuentra dentro del polígono según el ` fillRule` especificado; en caso contrario, devuelve ` false`.

QPolygon QPolygon::intersected(const QPolygon &r) const

Devuelve un polígono que es la intersección de este polígono y r.

Las operaciones de conjunto sobre polígonos tratarán a los polígonos como áreas. Los polígonos no cerrados se tratarán como si estuvieran implícitamente cerrados.

Véase también intersects().

bool QPolygon::intersects(const QPolygon &p) const

Devuelve « true » si el polígono actual se cruza en algún punto con el polígono dado « p ». También devuelve « true » si el polígono actual contiene o está contenido por alguna parte de « p ».

Las operaciones de conjunto sobre polígonos tratarán a los polígonos como áreas. Los polígonos no cerrados se tratarán como si estuvieran implícitamente cerrados.

Véase también intersected().

void QPolygon::point(int index, int *x, int *y) const

Extrae las coordenadas del punto situado en la dirección dada index a *x y *y (si son punteros válidos).

Véase también setPoint().

QPoint QPolygon::point(int index) const

Devuelve el punto situado en la coordenada index indicada.

Esta es una función sobrecargada.

void QPolygon::putPoints(int index, int nPoints, int firstx, int firsty, ...)

Copia los puntos nPoints de la lista de argumentos variables en este polígono a partir de la dirección index proporcionada.

Los puntos se proporcionan como una secuencia de números enteros, empezando por firstx, luego firsty, y así sucesivamente. El polígono se redimensiona si index+nPoints supera su tamaño actual.

El código de ejemplo crea un polígono con tres puntos (4,5), (6,7) y (8,9), ampliando el polígono de 1 a 3 puntos:

QPolygon polygon(1);
polygon[0] = QPoint(4, 5);
polygon.putPoints(1, 2, 6,7, 8,9);

El siguiente código ofrece el mismo resultado, pero en este caso la función `putPoints()` sobrescribe los puntos en lugar de ampliarlos:

QPolygon polygon(3);
polygon.putPoints(0, 3, 4,5, 0,0, 8,9);
polygon.putPoints(1, 1, 6,7);

Véase también ` setPoints()`.

void QPolygon::putPoints(int index, int nPoints, const QPolygon &fromPolygon, int fromIndex = 0)

Copia los puntos de nPoints desde el fromIndex indicado (0 por defecto) en fromPolygon a este polígono, comenzando por el index especificado. Por ejemplo:

QPolygon polygon1;
polygon1.putPoints(0, 3, 1,2, 0,0, 5,6);
// polygon1 is now the three-point polygon(1,2, 0,0, 5,6);

QPolygon polygon2;
polygon2.putPoints(0, 3, 4,4, 5,5, 6,6);
// polygon2 is now (4,4, 5,5, 6,6);

polygon1.putPoints(2, 3, polygon2);
// polygon1 is now the five-point polygon(1,2, 0,0, 4,4, 5,5, 6,6);

Esta es una función sobrecargada.

void QPolygon::setPoint(int index, int x, int y)

Establece el punto situado en la dirección index en el punto especificado por (x, y).

Véanse también point(), putPoints() y setPoints().

void QPolygon::setPoint(int index, const QPoint &point)

Establece el punto situado en la coordenada « index » en el valor « point ».

Esta es una función sobrecargada.

void QPolygon::setPoints(int nPoints, const int *points)

Cambia el tamaño del polígono a nPoints y lo rellena con el dato points.

El código de ejemplo crea un polígono con dos puntos (10, 20) y (30, 40):

static const int points[] = { 10, 20, 30, 40 };
QPolygon polygon;
polygon.setPoints(2, points);

Véanse también setPoint() y putPoints().

void QPolygon::setPoints(int nPoints, int firstx, int firsty, ...)

Cambia el tamaño del polígono a nPoints y lo rellena con los puntos especificados por la lista de argumentos variables. Los puntos se indican como una secuencia de números enteros, empezando por firstx, luego firsty, y así sucesivamente.

El código de ejemplo crea un polígono con dos puntos: (10, 20) y (30, 40):

QPolygon polygon;
polygon.setPoints(2, 10, 20, 30, 40);

Se trata de una función sobrecargada.

QPolygon QPolygon::subtracted(const QPolygon &r) const

Devuelve un polígono que se obtiene restando r de este polígono.

Las operaciones de unión entre polígonos tratarán a los polígonos como áreas. Los polígonos no cerrados se tratarán como si estuvieran implícitamente cerrados.

[noexcept] void QPolygon::swap(QPolygon &other)

Intercambia este polígono con other. Esta operación es muy rápida y nunca falla.

[since 6.4] QPolygonF QPolygon::toPolygonF() const

Devuelve este polígono con precisión de punto flotante.

Esta función se introdujo en Qt 6.4.

Véase también QPolygonF::toPolygon().

void QPolygon::translate(int dx, int dy)

Traslada todos los vértices del polígono en (dx, dy).

Véase también translated().

void QPolygon::translate(const QPoint &offset)

Traslada todos los vértices del polígono según la offset indicada.

Esta es una función sobrecargada.

Véase también translated().

QPolygon QPolygon::translated(int dx, int dy) const

Devuelve una copia del polígono trasladado mediante (dx, dy).

Véase también translate().

QPolygon QPolygon::translated(const QPoint &offset) const

Devuelve una copia del polígono desplazado según el valor dado en ` offset`.

Esta es una función sobrecargada.

Véase también translate().

QPolygon QPolygon::united(const QPolygon &r) const

Devuelve un polígono que es la unión de este polígono y r.

Las operaciones de conjunto sobre polígonos tratarán a los polígonos como áreas y cerrarán implícitamente el polígono.

Véanse también intersected() y subtracted().

QPolygon::operator QVariant() const

Devuelve el polígono como un QVariant

Miembros no relacionados

QDataStream &operator<<(QDataStream &stream, const QPolygon &polygon)

Escribe el objeto ` polygon ` especificado en el objeto ` stream` especificado y devuelve una referencia al flujo.

Véase también «Serialización detipos de datos de Qt».

QDataStream &operator>>(QDataStream &stream, QPolygon &polygon)

Lee un polígono desde el archivo « stream » especificado y lo escribe en el archivo « polygon » especificado, y devuelve una referencia al flujo.

Véase también «Serialización detipos de datos de Qt».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.