QRect Class

Dokumentation der Mitgliedsfunktionen

[constexpr noexcept] QRect::QRect()

Erzeugt ein Null-Rechteck.

Siehe auch „ isNull()“.

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QPoint &bottomRight)

Erzeugt ein Rechteck mit den angegebenen Eckpunkten „ topLeft “ und „ bottomRight “, die beide im Rechteck enthalten sind.

Liegt bottomRight höher und links von topLeft, so schließt das definierte Rechteck die Ecken nicht mit ein.

Siehe auch setTopLeft(), setBottomRight() und span().

[constexpr noexcept] QRect::QRect(const QPoint &topLeft, const QSize &size)

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

Siehe auch setTopLeft() und setSize().

[constexpr noexcept] QRect::QRect(int x, int y, int width, int height)

Erzeugt ein Rechteck mit (x, y) als obere linke Ecke und den angegebenen Werten width und height.

Siehe auch setRect().

[constexpr noexcept] void QRect::adjust(int dx1, int dy1, int dx2, int dy2)

Fügt den bestehenden Koordinaten des Rechtecks jeweils dx1, dy1, dx2 und dy2 hinzu.

Siehe auch adjusted() und setRect().

[constexpr noexcept] QRect QRect::adjusted(int dx1, int dy1, int dx2, int 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.

Siehe auch adjust().

[constexpr noexcept] int QRect::bottom() const

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

Beachten Sie, dass diese Funktion aus historischen Gründen top() + height() - 1 zurückgibt; verwenden Sie y() + height(), um die tatsächliche y-Koordinate abzurufen.

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

[constexpr noexcept] QPoint QRect::bottomLeft() const

Gibt die Position der unteren linken Ecke des Rechtecks zurück. Beachten Sie, dass diese Funktion aus historischen Gründen QPoint(left(), top() + height() - 1) zurückgibt.

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

[constexpr noexcept] QPoint QRect::bottomRight() const

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

Beachten Sie, dass diese Funktion aus historischen Gründen QPoint(left() + width() -1, top() + height() - 1) zurückgibt.

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

[constexpr noexcept] QPoint QRect::center() const

Gibt den Mittelpunkt des Rechtecks zurück.

Siehe auch „ moveCenter()“.

[noexcept] bool QRect::contains(const QPoint &point, bool proper = false) const

Gibt „ true “ zurück, wenn der angegebene „ point “ innerhalb des Rechtecks oder an dessen Rand liegt; andernfalls wird „ false “ zurückgegeben. Ist „ proper “ wahr, gibt diese Funktion nur dann „ true “ zurück, wenn der angegebene „ point “ innerhalb des Rechtecks liegt (d. h. nicht am Rand).

Siehe auch intersects().

[noexcept] bool QRect::contains(const QRect &rectangle, bool proper = false) const

Gibt „ true “ zurück, wenn sich die angegebene „ rectangle “ innerhalb dieses Rechtecks befindet. Andernfalls wird „ false “ zurückgegeben. Ist „ proper “ wahr, gibt diese Funktion nur dann „ true “ zurück, wenn sich die „ rectangle “ vollständig innerhalb dieses Rechtecks befindet (und nicht am Rand).

[noexcept] bool QRect::contains(int x, int y) const

Gibt „ true “ zurück, wenn der Punkt (x, y) innerhalb dieses Rechtecks liegt, andernfalls „ false “.

[noexcept] bool QRect::contains(int x, int y, bool proper) const

Gibt „ true “ zurück, wenn der Punkt (x, y) innerhalb des Rechtecks oder auf dessen Kante liegt; andernfalls wird „ false “ zurückgegeben. Ist „ proper “ wahr, gibt diese Funktion nur dann „ true “ zurück, wenn der Punkt vollständig innerhalb des Rechtecks liegt (und nicht auf der Kante).

[constexpr] void QRect::getCoords(int *x1, int *y1, int *x2, int *y2) const

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

Siehe auch setCoords() und getRect().

[constexpr] void QRect::getRect(int *x, int *y, int *width, int *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] int QRect::height() const

Gibt die Höhe des Rechtecks zurück.

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

[noexcept] QRect QRect::intersected(const QRect &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 QRect::intersects(const QRect &rectangle) const

Gibt „ true “ zurück, wenn sich dieses Rechteck mit dem angegebenen „ rectangle “ überschneidet (d. h., es gibt mindestens ein Pixel, das sich in beiden Rechtecken befindet), andernfalls wird „ false “ zurückgegeben.

Das Schnittrechteck kann mit der Funktion ` intersected()` abgerufen werden.

Siehe auch contains().

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

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

Ein leeres Rechteck hat einen Wert von left() > right() oder top() > bottom(). 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 QRect::isNull() const

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

Bei einem Null-Rechteck sind sowohl die Breite als auch die Höhe auf 0 gesetzt (d. h., ` right()` == ` left()` - 1 und ` bottom()` == ` top()` - 1). Ein Null-Rechteck ist zudem leer und daher ungültig.

Siehe auch isEmpty() und isValid().

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

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

Ein gültiges Rechteck erfüllt die Bedingungen left() <= right() und top() <= bottom(). 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] int QRect::left() const

Gibt die x-Koordinate der linken Kante des Rechtecks zurück. Entspricht „ x()“.

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

[constexpr noexcept] QRect QRect::marginsAdded(const QMargins &margins) const

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

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

[constexpr noexcept] QRect QRect::marginsRemoved(const QMargins &margins) const

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

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

[constexpr noexcept] void QRect::moveBottom(int y)

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

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

[constexpr noexcept] void QRect::moveBottomLeft(const QPoint &position)

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

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

[constexpr noexcept] void QRect::moveBottomRight(const QPoint &position)

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

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

[constexpr noexcept] void QRect::moveCenter(const QPoint &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 QRect::moveLeft(int x)

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

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

[constexpr noexcept] void QRect::moveRight(int x)

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

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

[constexpr noexcept] void QRect::moveTo(const QPoint &position)

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

[constexpr noexcept] void QRect::moveTo(int x, int y)

Verschiebt das Rechteck, wobei die obere linke Ecke an der angegebenen Position verbleibt (x, y). Die Größe des Rechtecks bleibt unverändert.

Siehe auch translate() und moveTopLeft().

[constexpr noexcept] void QRect::moveTop(int y)

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

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

[constexpr noexcept] void QRect::moveTopLeft(const QPoint &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 QRect::moveTopRight(const QPoint &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] QRect QRect::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 die rechte Ecke; ist height() < 0, werden die obere und die untere Ecke vertauscht. Gleichzeitig werden die Ecken von „nicht inklusiv“ auf „inklusiv“ umgestellt.

Siehe auch isValid() und isEmpty().

[constexpr noexcept] int QRect::right() const

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

Beachten Sie, dass diese Funktion aus historischen Gründen den Wert „ left() + width() - 1“ zurückgibt; verwenden Sie „ x() + width()“, um die tatsächliche x-Koordinate abzurufen.

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

[constexpr noexcept] void QRect::setBottom(int y)

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

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

[constexpr noexcept] void QRect::setBottomLeft(const QPoint &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 unverändert.

Siehe auch bottomLeft() und moveBottomLeft().

[constexpr noexcept] void QRect::setBottomRight(const QPoint &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 stets unverändert.

Siehe auch bottomRight() und moveBottomRight().

[constexpr noexcept] void QRect::setCoords(int x1, int y1, int x2, int y2)

Setzt die Koordinaten der oberen linken Ecke des Rechtecks auf (x1, y1) und die Koordinaten der unteren rechten Ecke auf (x2, y2).

Siehe auch getCoords() und setRect().

[constexpr noexcept] void QRect::setHeight(int height)

Stellt die Höhe des Rechtecks auf den angegebenen Wert „ height “ ein. Die untere Kante wird geändert, die obere jedoch nicht.

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

[constexpr noexcept] void QRect::setLeft(int x)

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

Entspricht setX().

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

[constexpr noexcept] void QRect::setRect(int x, int y, int width, int height)

Setzt die Koordinaten der oberen linken Ecke des Rechtecks auf (x, y) und seine Größe auf die angegebenen Werte width und height.

Siehe auch getRect() und setCoords().

[constexpr noexcept] void QRect::setRight(int x)

Setzt den rechten Rand des Rechtecks auf die angegebene 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 QRect::setSize(const QSize &size)

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

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

[constexpr noexcept] void QRect::setTop(int y)

Setzt die Oberkante des Rechtecks auf die angegebene Koordinate „ y “. 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 QRect::setTopLeft(const QPoint &position)

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

Siehe auch topLeft() und moveTopLeft().

[constexpr noexcept] void QRect::setTopRight(const QPoint &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 QRect::setWidth(int width)

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

Siehe auch width() und setSize().

[constexpr noexcept] void QRect::setX(int x)

Setzt den linken Rand des Rechtecks auf die angegebene Koordinate „ x “. Die Breite kann sich dabei ändern, der rechte Rand des Rechtecks bleibt jedoch unverändert.

Entspricht setLeft().

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

[constexpr noexcept] void QRect::setY(int y)

Setzt die Oberkante des Rechtecks auf die angegebene 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] QSize QRect::size() const

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

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

[static constexpr noexcept, since 6.0] QRect QRect::span(const QPoint &p1, const QPoint &p2)

Gibt ein Rechteck zurück, das die beiden Punkte p1 und p2 umfasst, einschließlich dieser beiden Punkte und aller Punkte dazwischen.

Diese Funktion wurde in Qt 6.0 eingeführt.

[noexcept] CGRect QRect::toCGRect() const

Erstellt ein `CGRect` aus einem ` QRect`.

Siehe auch QRectF::fromCGRect().

[constexpr noexcept, since 6.4] QRectF QRect::toRectF() const

Gibt dieses Rechteck als Rechteck mit Gleitkommagenauigkeit zurück.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch ` QRectF::toRect()`.

[constexpr noexcept] int QRect::top() const

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

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

[constexpr noexcept] QPoint QRect::topLeft() const

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

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

[constexpr noexcept] QPoint QRect::topRight() const

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

Beachten Sie, dass diese Funktion aus historischen Gründen QPoint(left() + width() -1, top()) zurückgibt.

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

[constexpr noexcept] void QRect::translate(int dx, int 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.

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

[constexpr noexcept] void QRect::translate(const QPoint &offset)

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

[constexpr noexcept] QRect QRect::translated(int dx, int 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.

Siehe auch translate().

[constexpr noexcept] QRect QRect::translated(const QPoint &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] QRect QRect::transposed() const

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

QRect r = {15, 51, 42, 24};
r = r.transposed(); // r == {15, 51, 24, 42}

Siehe auch ` QSize::transposed()`.

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

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

Siehe auch ` intersected()`.

[constexpr noexcept] int QRect::width() const

Gibt die Breite des Rechtecks zurück.

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

[constexpr noexcept] int QRect::x() const

Gibt die x-Koordinate der linken Kante des Rechtecks zurück. Entspricht „ left()“.

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

[constexpr noexcept] int QRect::y() const

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

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

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

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

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

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

Schneidet dieses Rechteck mit dem angegebenen rectangle.

Siehe auch intersected() und operator&().

[constexpr noexcept] QRect &QRect::operator+=(const QMargins &margins)

Fügt dem Rechteck das „ margins “ hinzu und vergrößert es dadurch.

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

[constexpr noexcept] QRect &QRect::operator-=(const QMargins &margins)

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

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

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

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

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

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

Vereint dieses Rechteck mit dem angegebenen rectangle.

Siehe auch united() und operator|().