QPolygon Class

Documentation des fonctions membres

[constexpr noexcept] QPolygon::QPolygon()

Construit un polygone sans points.

Voir aussi QList::isEmpty().

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

Construit un polygone contenant l'adresse points spécifiée.

Voir aussi setPoints().

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

Construit un polygone à partir de rectangle. Si closed est faux, le polygone contient simplement les quatre points du rectangle ordonnés dans le sens des aiguilles d'une montre, sinon le cinquième point du polygone est fixé à rectangle.topLeft().

Notez que le coin inférieur droit du rectangle est situé à (rectangle.x() + rectangle.width(), rectangle.y() + rectangle.height()).

Voir également setPoints().

QRect QPolygon::boundingRect() const

Renvoie le rectangle de délimitation du polygone, ou QRect(0, 0, 0, 0) si le polygone est vide.

Voir aussi QList::isEmpty().

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

Renvoie true si l'objet donné point se trouve à l'intérieur du polygone selon fillRule; sinon, renvoie false.

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

Renvoie un polygone qui est l'intersection de ce polygone et de r.

Les opérations de définition sur les polygones traiteront les polygones comme des zones. Les polygones non fermés seront traités comme implicitement fermés.

Voir aussi intersects().

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

Renvoie true si le polygone actuel intersecte en tout point le polygone donné p. Renvoie également true si le polygone actuel contient ou est contenu par une partie quelconque de p.

Les opérations de définition sur les polygones traiteront les polygones comme des zones. Les polygones non fermés seront traités comme implicitement fermés.

Voir aussi intersected().

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

Extrait les coordonnées du point situé à l'adresse index vers *x et *y (s'il s'agit de pointeurs valides).

Voir aussi setPoint().

QPoint QPolygon::point(int index) const

Renvoie le point situé à l'adresse index.

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

Copie les points nPoints de la liste d'arguments variables dans ce polygone à partir de index.

Les points sont donnés sous la forme d'une séquence d'entiers, en commençant par firstx puis firsty, et ainsi de suite. Le polygone est redimensionné si index+nPoints dépasse sa taille actuelle.

Le code de l'exemple crée un polygone avec trois points (4,5), (6,7) et (8,9), en étendant le polygone de 1 à 3 points :

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

Le code suivant donne le même résultat, mais ici la fonction putPoints() écrase au lieu d'étendre :

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

Voir aussi setPoints().

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

Copie les points nPoints du site fromIndex ( 0 par défaut) dans fromPolygon dans ce polygone, en commençant par le site index. Par exemple :

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);

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

Définit le point à l'adresse index donnée comme étant le point spécifié par (x, y).

Voir aussi point(), putPoints() et setPoints().

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

Fixe le point situé à l'adresse index au point situé à l'adresse point.

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

Redimensionne le polygone à nPoints et le remplit avec les données points.

L'exemple de code crée un polygone avec deux points (10, 20) et (30, 40) :

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

Voir aussi setPoint() et putPoints().

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

Redimensionne le polygone à nPoints et le remplit avec les points spécifiés par la liste d'arguments variables. Les points sont donnés sous la forme d'une séquence d'entiers, en commençant par firstx puis firsty, et ainsi de suite.

L'exemple de code crée un polygone avec deux points (10, 20) et (30, 40) :

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

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

Renvoie un polygone qui est r soustrait de ce polygone.

Les opérations de définition sur les polygones traiteront les polygones comme des zones. Les polygones non fermés seront traités comme implicitement fermés.

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

Échange ce polygone avec other. Cette opération est très rapide et n'échoue jamais.

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

Renvoie ce polygone en tant que polygone avec une précision en virgule flottante.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi QPolygonF::toPolygon().

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

Traduit tous les points du polygone par (dx, dy).

Voir également translated().

void QPolygon::translate(const QPoint &offset)

Traduit tous les points du polygone par la valeur donnée offset.

Voir aussi translated().

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

Renvoie une copie du polygone traduit par (dx, dy).

Voir aussi translate().

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

Renvoie une copie du polygone qui est translaté par la valeur donnée offset.

Voir aussi translate().

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

Renvoie un polygone qui est l'union de ce polygone et de r.

Les opérations Set sur les polygones traiteront les polygones comme des zones et fermeront implicitement le polygone.

Voir aussi intersected() et subtracted().

QPolygon::operator QVariant() const

Renvoie le polygone sous forme de QVariant