QRectF Class

Dokumentation zu den Member-Funktionen

[constexpr noexcept] QRectF::QRectF()

Erzeugt ein Null-Rechteck.

Siehe auch „ isNull()“.

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

Erstellt ein QRectF-Rechteck aus dem angegebenen QRect rectangle .

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

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

Erstellt ein Rechteck mit den angegebenen Ecken topLeft und bottomRight.

Siehe auch setTopLeft() und setBottomRight().

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

Erzeugt ein Rechteck mit der angegebenen Ecke topLeft und dem angegebenen size.

Siehe auch setTopLeft() und setSize().

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

Erzeugt ein Rechteck mit (x, y) als linker oberer Ecke und den angegebenen Werten 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 den bestehenden Koordinaten des Rechtecks jeweils dx1, dy1, dx2 und dy2 hinzu. Alle Parameter müssen endliche Werte haben.

Siehe auch adjusted() und setRect().

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

Gibt ein neues Rechteck zurück, bei dem die Werte dx1, dy1, dx2 und dy2 jeweils zu den bestehenden Koordinaten dieses Rechtecks addiert wurden. Alle Parameter müssen endliche Werte sein.

Siehe auch adjust().

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

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

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

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

Gibt die Position der unteren linken 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 sich der angegebene Punkt „ point “ innerhalb oder am Rand des Rechtecks befindet; andernfalls wird „ false “ zurückgegeben.

Siehe auch intersects().

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

Gibt „ true “ zurück, wenn sich die angegebene „ rectangle “ innerhalb dieses Rechtecks befindet; andernfalls wird „ false “ zurückgegeben.

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

Gibt „ true “ zurück, wenn der Punkt (x, y) innerhalb des Rechtecks oder auf dessen Rand liegt; andernfalls wird „ false “ zurückgegeben.

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

Erzeugt ein „ QRectF “ aus einem „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 in QRectF. Das Verhalten ist undefiniert, wenn der übergebene 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 in *x1 und *y1 sowie die Position der rechten unteren Ecke in *x2 und *y2.

Siehe auch setCoords() und getRect().

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

Ruft die Position der oberen linken Ecke des Rechtecks unter *x und *y sowie dessen Abmessungen unter *width und *height ab.

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) “ gleichbedeutend ist mit „ r & s “.

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., wenn es einen nicht leeren Überlappungsbereich zwischen beiden gibt), andernfalls wird „ false “ zurückgegeben.

Das Schnittrechteck 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 ungültig (d. h. isEmpty() == !isValid()).

Verwenden Sie die Funktion „ normalized()“, um ein Rechteck abzurufen, bei dem die Ecken vertauscht sind.

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

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

Gibt „ true “ zurück, wenn es sich bei dem Rechteck um ein Null-Rechteck handelt, andernfalls „ false “.

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

Siehe auch isEmpty() und isValid().

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

Gibt „ true “ zurück, wenn das Rechteck gültig ist, andernfalls „ false “.

Ein gültiges Rechteck hat „ width()“ > 0 und „ height()“ > 0. Beachten Sie, dass nicht-triviale Operationen wie Schnittmengen 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. Entspricht „ x()“.

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

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

Gibt ein Rechteck zurück, das um den Wert ` margins` vergrößert wurde.

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

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

Entfernt die „ margins “ aus dem Rechteck und verkleinert es dadurch.

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

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

Verschiebt das Rechteck vertikal, wobei die Unterkante 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 untere linke Ecke an der angegebenen Position position verbleibt. 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 position verbleibt. 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 an der angegebenen Position position verbleibt. Die Größe des Rechtecks bleibt unverändert.

Siehe auch center().

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

Verschiebt das Rechteck horizontal, wobei die linke Kante 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 obere linke Ecke an der angegebenen Position verbleibt (x, y). Die Größe des Rechtecks bleibt unverändert. Beide Parameter müssen endliche Werte haben.

Siehe auch translate() und moveTopLeft().

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

Verschiebt das Rechteck so, dass die obere linke Ecke an der angegebenen Koordinate position verbleibt.

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

Verschiebt das Rechteck vertikal, wobei die obere Kante des Rechtecks an der angegebenen endlichen Koordinate y verbleibt. 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 obere linke Ecke an der angegebenen Position position verbleibt. 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 obere rechte Ecke an der angegebenen Position position verbleibt. 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 mit nicht-negativer Breite und Höhe.

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

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 die Unterkante des Rechtecks auf die angegebene endliche Koordinate im y -Koordinatensystem. Die Höhe kann sich dabei ändern, die Oberkante des Rechtecks bleibt jedoch unverändert.

Siehe auch „ bottom()“ und „ moveBottom()“.

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

Setze die linke untere Ecke des Rechtecks auf die angegebene Koordinate position. Die Größe kann sich ändern, die rechte obere Ecke des Rechtecks bleibt jedoch immer unverändert.

Siehe auch ` bottomLeft()` und ` moveBottomLeft()`.

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

Setze die rechte untere Ecke des Rechtecks auf die angegebene Koordinate position. Die Größe kann sich ändern, die linke obere Ecke des Rechtecks bleibt jedoch immer unverändert.

Siehe auch bottomRight() und moveBottomRight().

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

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

Siehe auch getCoords() und setRect().

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

Legt die Höhe des Rechtecks auf den angegebenen endlichen Wert height fest. Die untere Kante wird geändert, die obere jedoch nicht.

Siehe auch ` height()` und ` setSize()`.

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

Setzt die linke Kante des Rechtecks auf die angegebene endliche Koordinate „ x “. Die Breite kann sich dabei ändern, die rechte Kante des Rechtecks bleibt jedoch unverändert.

Entspricht setX().

Siehe auch „ left()“ und „ moveLeft()“.

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

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

Siehe auch getRect() und setCoords().

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

Setzt den rechten Rand des Rechtecks auf die angegebene endliche Koordinate x. Die Breite kann sich dabei ändern, der linke Rand des Rechtecks bleibt jedoch unverändert.

Siehe auch right() und moveRight().

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

Legt die Größe des Rechtecks auf den angegebenen endlichen Wert fest: size. Die linke obere Ecke wird nicht verschoben.

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

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

Setzt die Oberkante des Rechtecks auf die angegebene endliche Koordinate des „ y “ fest. Die Höhe kann sich dabei ändern, die Unterkante des Rechtecks bleibt jedoch unverändert.

Entspricht ` setY()`.

Siehe auch „ top()“ und „ moveTop()“.

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

Setze die obere linke Ecke des Rechtecks auf die angegebene Koordinate position. Die Größe kann sich ändern, die untere rechte Ecke des Rechtecks bleibt jedoch immer unverändert.

Siehe auch topLeft() und moveTopLeft().

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

Setze die obere rechte Ecke des Rechtecks auf die angegebene Koordinate position. Die Größe kann sich ändern, die untere linke Ecke des Rechtecks bleibt jedoch immer unverändert.

Siehe auch topRight() und moveTopRight().

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

Stellt die Breite des Rechtecks auf den angegebenen endlichen Wert width ein. Dabei wird die rechte Kante geändert, die linke jedoch nicht.

Siehe auch width() und setSize().

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

Setzt die linke Kante des Rechtecks auf die angegebene endliche Koordinate „ x “. Die Breite kann sich dabei ändern, die rechte Kante des Rechtecks bleibt jedoch unverändert.

Entspricht setLeft().

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

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

Setzt die Oberkante des Rechtecks auf die angegebene endliche Koordinate „ y “. Die Höhe kann sich dabei ändern, die Unterkante des Rechtecks bleibt jedoch unverändert.

Entspricht ` 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 ein „ QRect “ zurück, das auf den Werten dieses Rechtecks basiert und das kleinstmögliche ganzzahlige Rechteck darstellt, das dieses Rechteck vollständig enthält.

Siehe auch ` toRect()`.

[noexcept] CGRect QRectF::toCGRect() const

Erzeugt ein `CGRect` aus einem ` QRectF`.

Siehe auch fromCGRect().

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

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

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 ganze Zahl gerundet werden.

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

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

Gibt die y-Koordinate der Oberkante des Rechtecks zurück. Entspricht „ y()“.

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

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

Gibt die Position der oberen linken 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 um dx entlang der x-Achse und um dy entlang der y-Achse, relativ zur aktuellen Position. Positive Werte verschieben das Rechteck nach rechts und nach unten. Beide Parameter müssen endliche Werte haben.

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

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

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, das relativ zur aktuellen Position um dx entlang der x-Achse und um dy entlang der y-Achse verschoben wurde. Positive Werte verschieben das Rechteck nach rechts und nach unten. Beide Parameter müssen endlich sein.

Siehe auch translate().

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

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

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

Gibt eine Kopie des Rechtecks zurück, bei der Breite und Höhe vertauscht sind:

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

Gibt das umschließende Rechteck dieses Rechtecks und des angegebenen „ rectangle “ zurück.

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. Entspricht ` left()`.

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

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

Gibt die y-Koordinate der Oberkante des Rechtecks zurück. Entspricht top().

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

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

Gibt die Schnittmenge dieses Rechtecks und des angegebenen „ rectangle “ zurück. Wenn keine Schnittmenge vorliegt, wird ein leeres Rechteck zurückgegeben.

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 dem Rechteck das „ margins “ hinzu und vergrößert es dadurch.

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

Gibt das umschließende Rechteck dieses Rechtecks und des angegebenen rectangle zurück.

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

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

Vereint dieses Rechteck mit dem angegebenen rectangle.

Siehe auch united() und operator|().