QPolygon Class

Dokumentation zu den Mitgliedsfunktionen

[constexpr noexcept default] QPolygon::QPolygon()

Erstellt ein Polygon ohne Punkte.

Siehe auch „ QList::isEmpty()“.

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

Erstellt ein Polygon, das die angegebene points enthält.

Siehe auch setPoints().

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

Erstellt ein Polygon aus dem angegebenen „ rectangle “. Ist „ closed “ falsch, enthält das Polygon lediglich die vier Punkte des Rechtecks im Uhrzeigersinn angeordnet; andernfalls wird der fünfte Punkt des Polygons auf „ rectangle.topLeft()“ gesetzt.

Beachten Sie, dass sich die rechte untere Ecke des Rechtecks an der Position (rectangle.x() + rectangle.width(), rectangle.y() + rectangle.height()) befindet.

Siehe auch ` setPoints()`.

QRect QPolygon::boundingRect() const

Gibt das Umrandungsrechteck des Polygons zurück oder QRect(0, 0, 0, 0), wenn das Polygon leer ist.

Siehe auch ` QList::isEmpty()`.

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

Gibt „ true “ zurück, wenn sich die angegebene „ point “ gemäß dem angegebenen „ fillRule “ innerhalb des Polygons befindet; andernfalls wird „ false “ zurückgegeben.

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

Gibt ein Polygon zurück, das die Schnittmenge dieses Polygons und r darstellt.

Bei Verknüpfungsoperationen mit Polygonen werden die Polygone als Flächen behandelt. Nicht geschlossene Polygone werden implizit als geschlossen behandelt.

Siehe auch intersects().

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

Gibt „ true “ zurück, wenn das aktuelle Polygon an irgendeiner Stelle das angegebene Polygon p schneidet. Gibt außerdem „ true “ zurück, wenn das aktuelle Polygon einen Teil von p enthält oder von diesem Teil enthalten ist.

Bei Verknüpfungsoperationen mit Polygonen werden die Polygone als Flächen behandelt. Nicht geschlossene Polygone werden implizit als geschlossen behandelt.

Siehe auch „ intersected()“.

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

Extrahiert die Koordinaten des Punktes an der angegebenen Adresse index in *x und *y (sofern es sich um gültige Zeiger handelt).

Siehe auch setPoint().

QPoint QPolygon::point(int index) const

Gibt den Punkt an der angegebenen Koordinaten index zurück.

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

Kopiert nPoints Punkte aus der Liste der variablen Argumente in dieses Polygon aus der angegebenen Datei index.

Die Punkte werden als Folge von Ganzzahlen angegeben, beginnend mit firstx, gefolgt von firsty usw. Das Polygon wird in seiner Größe angepasst, wenn index+nPoints seine aktuelle Größe überschreitet.

Der Beispielcode erstellt ein Polygon mit den drei Punkten (4,5), (6,7) und (8,9), indem das Polygon von 1 auf 3 Punkte erweitert wird:

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

Der folgende Code führt zum gleichen Ergebnis, allerdings überschreibt die Funktion `putPoints()` hier die vorhandenen Punkte, anstatt sie zu erweitern:

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

Siehe auch ` setPoints()`.

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

Kopiert nPoints Punkte aus dem angegebenen fromIndex (Standardwert: 0) in fromPolygon in dieses Polygon, beginnend bei der angegebenen index. Beispiel:

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)

Setzt den Punkt an der angegebenen Adresse index auf den durch (x, y) angegebenen Punkt.

Siehe auch point(), putPoints() und setPoints().

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

Setzt den Punkt an der angegebenen Koordinate ` index ` auf die angegebene Koordinate ` point`.

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

Passen Sie die Größe des Polygons auf nPoints an und füllen Sie es mit dem angegebenen points.

Der Beispielcode erstellt ein Polygon mit den beiden Punkten (10, 20) und (30, 40):

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

Siehe auch setPoint() und putPoints().

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

Passen Sie die Größe des Polygons auf nPoints an und füllen Sie es mit den Punkten, die durch die Liste der variablen Argumente angegeben werden. Die Punkte werden als Folge von Ganzzahlen angegeben, beginnend mit firstx, gefolgt von firsty und so weiter.

Der Beispielcode erstellt ein Polygon mit den beiden Punkten (10, 20) und (30, 40):

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

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

Gibt ein Polygon zurück, das um das Polygon „ r “ von diesem Polygon abgezogen wurde.

Bei Verknüpfungsoperationen mit Polygonen werden die Polygone als Flächen behandelt. Nicht geschlossene Polygone werden implizit als geschlossen behandelt.

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

Tauscht dieses Polygon mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

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

Gibt dieses Polygon als Polygon mit Gleitkommagenauigkeit zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch „ QPolygonF::toPolygon()“.

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

Verschiebt alle Punkte des Polygons um (dx, dy).

Siehe auch translated().

void QPolygon::translate(const QPoint &offset)

Verschiebt alle Punkte des Polygons um den angegebenen „ offset “.

Siehe auch ` translated()`.

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

Gibt eine Kopie des Polygons zurück, das um (dx, dy) verschoben wurde.

Siehe auch translate().

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

Gibt eine Kopie des Polygons zurück, die um den angegebenen Wert ` offset` verschoben wurde.

Siehe auch ` translate()`.

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

Gibt ein Polygon zurück, das die Vereinigung dieses Polygons und von r darstellt.

Bei Vereinigungsoperationen mit Polygonen werden die Polygone als Flächen behandelt und das Polygon implizit geschlossen.

Siehe auch intersected() und subtracted().

QPolygon::operator QVariant() const

Gibt das Polygon als QVariant