QRectF Class

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] QRectF::QRectF()

Konstruiert ein Null-Rechteck.

Siehe auch isNull().

[constexpr noexcept] QRectF::QRectF(const QRect &rectangle)

Konstruiert ein QRectF-Rechteck aus dem angegebenen QRect rectangle .

Siehe auch toRect() und QRect::toRectF().

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QPointF &bottomRight)

Konstruiert ein Rechteck mit den angegebenen topLeft und bottomRight Ecken.

Siehe auch setTopLeft() und setBottomRight().

[constexpr noexcept] QRectF::QRectF(const QPointF &topLeft, const QSizeF &size)

Konstruiert ein Rechteck mit der angegebenen topLeft Ecke und der angegebenen size.

Siehe auch setTopLeft() und setSize().

[constexpr noexcept] QRectF::QRectF(qreal x, qreal y, qreal width, qreal height)

Konstruiert ein Rechteck mit (x, y) als oberer linker Ecke und den angegebenen width und height. Alle Parameter müssen endlich sein.

Siehe auch setRect().

[constexpr noexcept] void QRectF::adjust(qreal dx1, qreal dy1, qreal dx2, qreal dy2)

Fügt dx1, dy1, dx2 und dy2 jeweils zu den vorhandenen Koordinaten des Rechtecks hinzu. Alle Parameter müssen endlich sein.

Siehe auch adjusted() und setRect().

[constexpr noexcept] QRectF QRectF::adjusted(qreal dx1, qreal dy1, qreal dx2, qreal dy2) const

Gibt ein neues Rechteck mit dx1, dy1, dx2 und dy2 zurück, das zu den bestehenden Koordinaten dieses Rechtecks hinzugefügt wird. Alle Parameter müssen endlich sein.

Siehe auch adjust().

[constexpr noexcept] qreal QRectF::bottom() const

Gibt die y-Koordinate der unteren Kante des Rechtecks zurück.

Siehe auch setBottom(), bottomLeft(), und bottomRight().

[constexpr noexcept] QPointF QRectF::bottomLeft() const

Gibt die Position der linken unteren Ecke des Rechtecks zurück.

Siehe auch setBottomLeft(), bottom(), und left().

[constexpr noexcept] QPointF QRectF::bottomRight() const

Gibt die Position der rechten unteren Ecke des Rechtecks zurück.

Siehe auch setBottomRight(), bottom(), und right().

[constexpr noexcept] QPointF QRectF::center() const

Gibt den Mittelpunkt des Rechtecks zurück.

Siehe auch moveCenter().

[noexcept] bool QRectF::contains(const QPointF &point) const

Gibt true zurück, wenn die angegebene point innerhalb oder auf dem Rand des Rechtecks liegt; andernfalls wird false zurückgegeben.

Siehe auch intersects().

[noexcept] bool QRectF::contains(const QRectF &rectangle) const

Dies ist eine überladene Funktion.

Gibt true zurück, wenn die angegebene rectangle innerhalb dieses Rechtecks liegt; andernfalls gibt sie false zurück.

[noexcept] bool QRectF::contains(qreal x, qreal y) const

Dies ist eine überladene Funktion.

Gibt true zurück, wenn der Punkt (x, y) innerhalb oder auf dem Rand des Rechtecks liegt; andernfalls gibt sie false zurück.

[static noexcept] QRectF QRectF::fromCGRect(CGRect rect)

Erzeugt ein QRectF aus CGRect rect.

Siehe auch toCGRect().

[static, since 6.5] QRectF QRectF::fromDOMRect(emscripten::val domRect)

Konvertiert das DOMRect (https://www.w3.org/TR/geometry-1/) domRect nach QRectF. Das Verhalten ist undefiniert, wenn der angegebene Parameter kein DOMRect ist.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch toDOMRect().

[constexpr] void QRectF::getCoords(qreal *x1, qreal *y1, qreal *x2, qreal *y2) const

Extrahiert die Position der linken oberen Ecke des Rechtecks nach *x1 und *y1, und die Position der rechten unteren Ecke nach *x2 und *y2.

Siehe auch setCoords() und getRect().

[constexpr] void QRectF::getRect(qreal *x, qreal *y, qreal *width, qreal *height) const

Extrahiert die Position der linken oberen Ecke des Rechtecks nach *x und *y und seine Abmessungen nach *width und *height.

Siehe auch setRect() und getCoords().

[constexpr noexcept] qreal QRectF::height() const

Gibt die Höhe des Rechtecks zurück.

Siehe auch setHeight(), width(), und size().

[noexcept] QRectF QRectF::intersected(const QRectF &rectangle) const

Gibt die Schnittmenge dieses Rechtecks mit dem angegebenen rectangle zurück. Beachten Sie, dass r.intersected(s) äquivalent zu r & s ist.

Siehe auch intersects(), united(), und operator&=().

[noexcept] bool QRectF::intersects(const QRectF &rectangle) const

Gibt true zurück, wenn sich dieses Rechteck mit dem angegebenen rectangle schneidet (d. h. es gibt einen nicht leeren Überlappungsbereich zwischen ihnen), andernfalls false.

Das Schnittpunkt-Rechteck kann mit der Funktion intersected() abgerufen werden.

Siehe auch contains().

[constexpr noexcept] bool QRectF::isEmpty() const

Gibt true zurück, wenn das Rechteck leer ist, andernfalls false.

Ein leeres Rechteck hat width() <= 0 oder height() <= 0. Ein leeres Rechteck ist nicht gültig (d. h. isEmpty() == !isValid()).

Verwenden Sie die Funktion normalized(), um ein Rechteck zu erhalten, bei dem die Ecken vertauscht sind.

Siehe auch isNull(), isValid(), und normalized().

[constexpr noexcept] bool QRectF::isNull() const

Gibt true zurück, wenn das Rechteck ein Null-Rechteck ist, andernfalls wird false zurückgegeben.

Bei einem Null-Rechteck sind sowohl die Breite als auch die Höhe auf 0 gesetzt. Ein Null-Rechteck ist auch leer und daher nicht gültig.

Siehe auch isEmpty() und isValid().

[constexpr noexcept] bool QRectF::isValid() const

Gibt true zurück, wenn das Rechteck gültig ist, andernfalls wird false zurückgegeben.

Ein gültiges Rechteck hat einen width() > 0 und height() > 0. Beachten Sie, dass nicht-triviale Operationen wie Schnittpunkte für ungültige Rechtecke nicht definiert sind. Ein gültiges Rechteck ist nicht leer (d. h., isValid() == !isEmpty()).

Siehe auch isNull(), isEmpty(), und normalized().

[constexpr noexcept] qreal QRectF::left() const

Gibt die x-Koordinate der linken Kante des Rechtecks zurück. Äquivalent zu x().

Siehe auch setLeft(), topLeft(), und bottomLeft().

[constexpr noexcept] QRectF QRectF::marginsAdded(const QMarginsF &margins) const

Gibt ein Rechteck zurück, das durch margins vergrößert wurde.

Siehe auch operator+=(), marginsRemoved(), und operator-=().

[constexpr noexcept] QRectF QRectF::marginsRemoved(const QMarginsF &margins) const

Entfernt das margins aus dem Rechteck und verkleinert es.

Siehe auch marginsAdded(), operator+=(), und operator-=().

[constexpr noexcept] void QRectF::moveBottom(qreal y)

Verschiebt das Rechteck vertikal, wobei der untere Rand des Rechtecks an der angegebenen endlichen Koordinate y verbleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch bottom(), setBottom(), und moveTop().

[constexpr noexcept] void QRectF::moveBottomLeft(const QPointF &position)

Verschiebt das Rechteck, wobei die linke untere Ecke an der angegebenen position bleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch setBottomLeft(), moveBottom(), und moveLeft().

[constexpr noexcept] void QRectF::moveBottomRight(const QPointF &position)

Verschiebt das Rechteck, wobei die rechte untere Ecke an der angegebenen position bleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch setBottomRight(), moveBottom(), und moveRight().

[constexpr noexcept] void QRectF::moveCenter(const QPointF &position)

Verschiebt das Rechteck, wobei der Mittelpunkt auf dem angegebenen position bleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch center().

[constexpr noexcept] void QRectF::moveLeft(qreal x)

Verschiebt das Rechteck horizontal, wobei der linke Rand des Rechtecks an der angegebenen endlichen Koordinate x verbleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch left(), setLeft(), und moveRight().

[constexpr noexcept] void QRectF::moveRight(qreal x)

Verschiebt das Rechteck horizontal, wobei der rechte Rand des Rechtecks an der angegebenen endlichen Koordinate x verbleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch right(), setRight(), und moveLeft().

[constexpr noexcept] void QRectF::moveTo(qreal x, qreal y)

Verschiebt das Rechteck, wobei die linke obere Ecke an der angegebenen Position bleibt (x, y). Die Größe des Rechtecks bleibt unverändert. Beide Parameter müssen endlich sein.

Siehe auch translate() und moveTopLeft().

[constexpr noexcept] void QRectF::moveTo(const QPointF &position)

Dies ist eine überladene Funktion.

Verschiebt das Rechteck, wobei die linke obere Ecke an der angegebenen position bleibt.

[constexpr noexcept] void QRectF::moveTop(qreal y)

Verschiebt das Rechteck vertikal, wobei die obere Linie des Rechtecks an der angegebenen endlichen Koordinate y bleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch top(), setTop(), und moveBottom().

[constexpr noexcept] void QRectF::moveTopLeft(const QPointF &position)

Verschiebt das Rechteck, wobei die linke obere Ecke an der angegebenen position bleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch setTopLeft(), moveTop(), und moveLeft().

[constexpr noexcept] void QRectF::moveTopRight(const QPointF &position)

Verschiebt das Rechteck, wobei die rechte obere Ecke an der angegebenen position bleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch setTopRight(), moveTop(), und moveRight().

[noexcept] QRectF QRectF::normalized() const

Gibt ein normalisiertes Rechteck zurück, d.h. ein Rechteck, das eine nicht-negative Breite und Höhe hat.

Wenn width() < 0 ist, vertauscht die Funktion die linke und rechte Ecke, und sie vertauscht die obere und untere Ecke, wenn height() < 0 ist.

Siehe auch isValid() und isEmpty().

[constexpr noexcept] qreal QRectF::right() const

Gibt die x-Koordinate der rechten Kante des Rechtecks zurück.

Siehe auch setRight(), topRight(), und bottomRight().

[constexpr noexcept] void QRectF::setBottom(qreal y)

Setzt den unteren Rand des Rechtecks auf die angegebene endliche Koordinate y. Kann die Höhe ändern, wird aber nie die obere Kante des Rechtecks ändern.

Siehe auch bottom() und moveBottom().

[constexpr noexcept] void QRectF::setBottomLeft(const QPointF &position)

Setzt die untere linke Ecke des Rechtecks auf die angegebene position. Kann die Größe ändern, ändert aber nie die obere rechte Ecke des Rechtecks.

Siehe auch bottomLeft() und moveBottomLeft().

[constexpr noexcept] void QRectF::setBottomRight(const QPointF &position)

Setzt die rechte untere Ecke des Rechtecks auf die angegebene position. Kann die Größe ändern, ändert aber nie die linke obere Ecke des Rechtecks.

Siehe auch bottomRight() und moveBottomRight().

[constexpr noexcept] void QRectF::setCoords(qreal x1, qreal y1, qreal x2, qreal y2)

Setzt die Koordinaten der linken oberen Ecke des Rechtecks auf (x1, y1), und die Koordinaten der rechten unteren Ecke auf (x2, y2). Alle Parameter müssen endlich sein.

Siehe auch getCoords() und setRect().

[constexpr noexcept] void QRectF::setHeight(qreal height)

Setzt die Höhe des Rechtecks auf die angegebene endliche height. Die untere Kante wird geändert, nicht aber die obere.

Siehe auch height() und setSize().

[constexpr noexcept] void QRectF::setLeft(qreal x)

Setzt den linken Rand des Rechtecks auf die angegebene endliche Koordinate x. Kann die Breite ändern, wird aber nie den rechten Rand des Rechtecks ändern.

Äquivalent zu setX().

Siehe auch left() und moveLeft().

[constexpr noexcept] void QRectF::setRect(qreal x, qreal y, qreal width, qreal height)

Setzt die Koordinaten der linken oberen Ecke des Rechtecks auf (x, y), und seine Größe auf die angegebenen width und height. Alle Parameter müssen endlich sein.

Siehe auch getRect() und setCoords().

[constexpr noexcept] void QRectF::setRight(qreal x)

Setzt den rechten Rand des Rechtecks auf die angegebene endliche Koordinate x. Kann die Breite ändern, ändert aber nie den linken Rand des Rechtecks.

Siehe auch right() und moveRight().

[constexpr noexcept] void QRectF::setSize(const QSizeF &size)

Setzt die Größe des Rechtecks auf die angegebene endliche size. Die linke obere Ecke wird nicht verschoben.

Siehe auch size(), setWidth(), und setHeight().

[constexpr noexcept] void QRectF::setTop(qreal y)

Setzt den oberen Rand des Rechtecks auf die angegebene endliche Koordinate y. Kann die Höhe ändern, wird aber nie die untere Kante des Rechtecks ändern.

Äquivalent zu setY().

Siehe auch top() und moveTop().

[constexpr noexcept] void QRectF::setTopLeft(const QPointF &position)

Setzt die linke obere Ecke des Rechtecks auf die angegebene position. Kann die Größe ändern, ändert aber nie die untere rechte Ecke des Rechtecks.

Siehe auch topLeft() und moveTopLeft().

[constexpr noexcept] void QRectF::setTopRight(const QPointF &position)

Setzt die rechte obere Ecke des Rechtecks auf die angegebene position. Kann die Größe ändern, wird aber nie die linke untere Ecke des Rechtecks ändern.

Siehe auch topRight() und moveTopRight().

[constexpr noexcept] void QRectF::setWidth(qreal width)

Setzt die Breite des Rechtecks auf die angegebene endliche width. Der rechte Rand wird geändert, der linke jedoch nicht.

Siehe auch width() und setSize().

[constexpr noexcept] void QRectF::setX(qreal x)

Setzt den linken Rand des Rechtecks auf die angegebene endliche Koordinate x. Kann die Breite ändern, wird aber nie den rechten Rand des Rechtecks ändern.

Äquivalent zu setLeft().

Siehe auch x(), setY(), und setTopLeft().

[constexpr noexcept] void QRectF::setY(qreal y)

Setzt den oberen Rand des Rechtecks auf die angegebene endliche Koordinate y. Kann die Höhe ändern, wird aber nie die untere Kante des Rechtecks ändern.

Äquivalent zu setTop().

Siehe auch y(), setX(), und setTopLeft().

[constexpr noexcept] QSizeF QRectF::size() const

Gibt die Größe des Rechtecks zurück.

Siehe auch setSize(), width(), und height().

[noexcept] QRect QRectF::toAlignedRect() const

Gibt auf der Grundlage der Werte dieses Rechtecks ein QRect zurück, das das kleinstmögliche ganzzahlige Rechteck ist, das dieses Rechteck vollständig enthält.

Siehe auch toRect().

[noexcept] CGRect QRectF::toCGRect() const

Erzeugt einen CGRect aus einem QRectF.

Siehe auch fromCGRect().

[since 6.5] emscripten::val QRectF::toDOMRect() const

Konvertiert dieses Objekt in ein DOMRect (https://www.w3.org/TR/geometry-1/).

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch fromDOMRect().

[constexpr noexcept] QRect QRectF::toRect() const

Gibt ein QRect zurück, das auf den Werten dieses Rechtecks basiert. Beachten Sie, dass die Koordinaten im zurückgegebenen Rechteck auf die nächste Ganzzahl gerundet werden.

Siehe auch QRectF(), toAlignedRect(), und QRect::toRectF().

[constexpr noexcept] qreal QRectF::top() const

Gibt die y-Koordinate der oberen Kante des Rechtecks zurück. Äquivalent zu y().

Siehe auch setTop(), topLeft(), und topRight().

[constexpr noexcept] QPointF QRectF::topLeft() const

Gibt die Position der linken oberen Ecke des Rechtecks zurück.

Siehe auch setTopLeft(), top(), und left().

[constexpr noexcept] QPointF QRectF::topRight() const

Gibt die Position der oberen rechten Ecke des Rechtecks zurück.

Siehe auch setTopRight(), top(), und right().

[constexpr noexcept] void QRectF::translate(qreal dx, qreal dy)

Verschiebt das Rechteck dx entlang der x-Achse und dy entlang der y-Achse, relativ zur aktuellen Position. Positive Werte verschieben das Rechteck nach rechts und nach unten. Beide Parameter müssen endlich sein.

Siehe auch moveTopLeft(), moveTo(), und translated().

[constexpr noexcept] void QRectF::translate(const QPointF &offset)

Dies ist eine überladene Funktion.

Verschiebt das Rechteck offset.x() entlang der x-Achse und offset.y() entlang der y-Achse, relativ zur aktuellen Position.

[constexpr noexcept] QRectF QRectF::translated(qreal dx, qreal dy) const

Gibt eine Kopie des Rechtecks zurück, die relativ zur aktuellen Position um dx entlang der x-Achse und dy entlang der y-Achse verschoben wird. Positive Werte verschieben das Rechteck nach rechts und unten. Beide Parameter müssen endlich sein.

Siehe auch translate().

[constexpr noexcept] QRectF QRectF::translated(const QPointF &offset) const

Dies ist eine überladene Funktion.

Gibt eine Kopie des Rechtecks zurück, die offset.x() entlang der x-Achse und offset.y() entlang der y-Achse relativ zur aktuellen Position verschoben wird.

[constexpr noexcept] QRectF QRectF::transposed() const

Gibt eine Kopie des Rechtecks zurück, bei der die Breite und Höhe ausgetauscht wurden:

QRectF r = {1.5, 5.1, 4.2, 2.4};
r = r.transposed(); // r == {1.5, 5.1, 2.4, 4.2}

Siehe auch QSizeF::transposed().

[noexcept] QRectF QRectF::united(const QRectF &rectangle) const

Liefert das Begrenzungsrechteck dieses Rechtecks und das angegebene rectangle.

Siehe auch intersected().

[constexpr noexcept] qreal QRectF::width() const

Gibt die Breite des Rechtecks zurück.

Siehe auch setWidth(), height(), und size().

[constexpr noexcept] qreal QRectF::x() const

Gibt die x-Koordinate der linken Kante des Rechtecks zurück. Äquivalent zu left().

Siehe auch setX(), y(), und topLeft().

[constexpr noexcept] qreal QRectF::y() const

Gibt die y-Koordinate der oberen Kante des Rechtecks zurück. Äquivalent zu top().

Siehe auch setY(), x(), und topLeft().

[noexcept] QRectF QRectF::operator&(const QRectF &rectangle) const

Gibt den Schnittpunkt dieses Rechtecks mit dem angegebenen rectangle zurück. Gibt ein leeres Rechteck zurück, wenn es keinen Schnittpunkt gibt.

Siehe auch operator&=() und intersected().

[noexcept] QRectF &QRectF::operator&=(const QRectF &rectangle)

Schneidet dieses Rechteck mit dem angegebenen rectangle.

Siehe auch intersected() und operator&().

[constexpr noexcept] QRectF &QRectF::operator+=(const QMarginsF &margins)

Fügt das margins zum Rechteck hinzu und vergrößert es.

Siehe auch marginsAdded(), marginsRemoved(), und operator-=().

[constexpr noexcept] QRectF &QRectF::operator-=(const QMarginsF &margins)

Gibt ein Rechteck zurück, das um den Wert margins verkleinert wurde.

Siehe auch marginsRemoved(), operator+=(), und marginsAdded().

[noexcept] QRectF QRectF::operator|(const QRectF &rectangle) const

Liefert das Begrenzungsrechteck dieses Rechtecks und das angegebene rectangle.

Siehe auch united() und operator|=().

[noexcept] QRectF &QRectF::operator|=(const QRectF &rectangle)

Vereinigt dieses Rechteck mit dem angegebenen rectangle.

Siehe auch united() und operator|().