QGraphicsRectItem Class
Die Klasse „QGraphicsRectItem“ stellt ein Rechteck-Element bereit, das Sie zu einem „ QGraphicsScene “ hinzufügen können. Mehr...
| Header: | #include <QGraphicsRectItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | QAbstractGraphicsShapeItem |
Öffentliche Typen
| enum { Type } |
Öffentliche Funktionen
| QGraphicsRectItem(QGraphicsItem *parent = nullptr) | |
| QGraphicsRectItem(const QRectF &rect, QGraphicsItem *parent = nullptr) | |
| QGraphicsRectItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr) | |
| virtual | ~QGraphicsRectItem() |
| QRectF | rect() const |
| void | setRect(const QRectF &rectangle) |
| void | setRect(qreal x, qreal y, qreal width, qreal height) |
Neu implementierte öffentliche Funktionen
| virtual QRectF | boundingRect() const override |
| virtual bool | contains(const QPointF &point) const override |
| virtual bool | isObscuredBy(const QGraphicsItem *item) const override |
| virtual QPainterPath | opaqueArea() const override |
| virtual void | paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr) override |
| virtual QPainterPath | shape() const override |
| virtual int | type() const override |
Ausführliche Beschreibung
Um das Rechteck des Elements festzulegen, übergeben Sie ein ` QRectF ` an den Konstruktor von `QGraphicsRectItem` oder rufen Sie die Funktion ` setRect()` auf. Die Funktion ` rect()` gibt das aktuelle Rechteck zurück.
QGraphicsRectItem verwendet das Rechteck und die Stiftbreite, um eine sinnvolle Implementierung von ` boundingRect()`, ` shape()` und ` contains()` bereitzustellen. Die Funktion ` paint()` zeichnet das Rechteck mit dem dem Element zugeordneten Stift und Pinsel, die Sie durch Aufruf der Funktionen ` setPen()` und ` setBrush()` festlegen können.
Hinweis: Die Darstellung ungültiger Rechtecke, beispielsweise solcher mit negativen Breiten oder Höhen, ist nicht definiert. Wenn Sie nicht sicher sein können, dass Sie gültige Rechtecke verwenden (beispielsweise wenn Sie Rechtecke anhand von Daten aus einer unzuverlässigen Quelle erstellen), sollten Sie die Funktion „ QRectF::normalized()“ verwenden, um normalisierte Rechtecke zu erstellen, und stattdessen diese verwenden.
Siehe auch „ QGraphicsPathItem“ , „ QGraphicsEllipseItem “, „ QGraphicsPolygonItem “, „ QGraphicsTextItem “, „ QGraphicsLineItem “, „ QGraphicsPixmapItem “ und „Graphics View Framework“.
Dokumentation zu Mitgliedstypen
[anonymous] enum
Der von der virtuellen Funktion ` type()` zurückgegebene Wert.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGraphicsRectItem::Type | 3 | Ein Grafik-Rechteck-Element |
Dokumentation der Mitgliedsfunktionen
[explicit] QGraphicsRectItem::QGraphicsRectItem(QGraphicsItem *parent = nullptr)
Erstellt ein `QGraphicsRectItem`. ` parent ` wird an den Konstruktor von ` QAbstractGraphicsShapeItem` übergeben.
Siehe auch QGraphicsScene::addItem().
[explicit] QGraphicsRectItem::QGraphicsRectItem(const QRectF &rect, QGraphicsItem *parent = nullptr)
Erstellt ein `QGraphicsRectItem` und verwendet dabei ` rect ` als Standardrechteck. ` parent ` wird an den Konstruktor von ` QAbstractGraphicsShapeItem` übergeben.
Siehe auch QGraphicsScene::addItem().
[explicit] QGraphicsRectItem::QGraphicsRectItem(qreal x, qreal y, qreal width, qreal height, QGraphicsItem *parent = nullptr)
Erzeugt ein `QGraphicsRectItem` mit einem Standardrechteck, das durch (x, y) definiert ist, sowie den angegebenen Werten für ` width ` und ` height`.
parent wird an den Konstruktor von ` QAbstractGraphicsShapeItem` übergeben.
Siehe auch ` QGraphicsScene::addItem()`.
[virtual noexcept] QGraphicsRectItem::~QGraphicsRectItem()
Zerstört den „ QGraphicsRectItem “.
[override virtual] QRectF QGraphicsRectItem::boundingRect() const
Implementiert: ` QGraphicsItem::boundingRect()` const.
[override virtual] bool QGraphicsRectItem::contains(const QPointF &point) const
Implementiert neu: ` QGraphicsItem::contains(const QPointF &point) const`.
[override virtual] bool QGraphicsRectItem::isObscuredBy(const QGraphicsItem *item) const
Implementiert: ` QAbstractGraphicsShapeItem::isObscuredBy(const QGraphicsItem *item) const`.
[override virtual] QPainterPath QGraphicsRectItem::opaqueArea() const
Implementiert: ` QAbstractGraphicsShapeItem::opaqueArea()` const.
[override virtual] void QGraphicsRectItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)
Implementiert: ` QGraphicsItem::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget`).
QRectF QGraphicsRectItem::rect() const
Gibt das Rechteck des Elements zurück.
Siehe auch ` setRect()`.
void QGraphicsRectItem::setRect(const QRectF &rectangle)
Legt das Rechteck des Elements auf die angegebene Adresse „ rectangle “ fest.
Siehe auch ` rect()`.
void QGraphicsRectItem::setRect(qreal x, qreal y, qreal width, qreal height)
Setzt das Rechteck des Elements auf das Rechteck, das durch (x, y) sowie die angegebenen Werte width und height definiert ist.
Diese Komfortfunktion entspricht dem Aufruf von setRect(QRectF(x, y, width, height))
Siehe auch rect().
[override virtual] QPainterPath QGraphicsRectItem::shape() const
Implementiert: ` QGraphicsItem::shape()` const.
[override virtual] int QGraphicsRectItem::type() const
Implementiert: ` QGraphicsItem::type()` const.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
