QGraphicsView Class

Dokumentation der Mitgliedsfunktionen

QGraphicsView::QGraphicsView(QWidget *parent = nullptr)

Konstruiert eine QGraphicsView. parent wird an den Konstruktor von QWidget übergeben.

QGraphicsView::QGraphicsView(QGraphicsScene *scene, QWidget *parent = nullptr)

Konstruiert eine QGraphicsView und setzt die visualisierte Szene auf scene. parent wird an den Konstruktor von QWidget übergeben.

[virtual noexcept] QGraphicsView::~QGraphicsView()

Zerstört das Objekt QGraphicsView.

void QGraphicsView::centerOn(const QPointF &pos)

Scrollt den Inhalt des Ansichtsfensters, um sicherzustellen, dass die Szenenkoordinate pos in der Ansicht zentriert ist.

Da pos eine Fließkommakoordinate ist und die Bildlaufleisten mit Ganzzahlkoordinaten arbeiten, ist die Zentrierung nur eine Annäherung.

Siehe auch ensureVisible().

void QGraphicsView::centerOn(const QGraphicsItem *item)

Dies ist eine überladene Funktion.

Scrollt den Inhalt des Ansichtsfensters, um sicherzustellen, dass item in der Ansicht zentriert ist.

Siehe auch ensureVisible().

void QGraphicsView::centerOn(qreal x, qreal y)

Dies ist eine überladene Funktion.

Diese Funktion wird aus Gründen der Bequemlichkeit bereitgestellt. Sie ist gleichbedeutend mit dem Aufruf von centerOn(QPointF(x, y)).

[override virtual protected] void QGraphicsView::contextMenuEvent(QContextMenuEvent *event)

Reimplements: QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e).

[override virtual protected] void QGraphicsView::dragEnterEvent(QDragEnterEvent *event)

Reimplements: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).

[override virtual protected] void QGraphicsView::dragLeaveEvent(QDragLeaveEvent *event)

Reimplements: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QGraphicsView::dragMoveEvent(QDragMoveEvent *event)

Reimplements: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event).

[virtual protected] void QGraphicsView::drawBackground(QPainter *painter, const QRectF &rect)

Zeichnet den Hintergrund der Szene unter Verwendung von painter, bevor Elemente und der Vordergrund gezeichnet werden. Implementieren Sie diese Funktion neu, um einen benutzerdefinierten Hintergrund für diese Ansicht zu erstellen.

Wenn Sie nur eine Farbe, eine Textur oder einen Farbverlauf für den Hintergrund definieren wollen, können Sie stattdessen setBackgroundBrush() aufrufen.

Alle Malvorgänge werden in Szenekoordinaten durchgeführt. rect ist das freigelegte Rechteck.

Die Standardimplementierung füllt rect mit dem backgroundBrush der Ansicht. Wenn kein solcher Pinsel definiert ist (die Vorgabe), wird stattdessen die Funktion drawBackground() der Szene aufgerufen.

Siehe auch drawForeground() und QGraphicsScene::drawBackground().

[virtual protected] void QGraphicsView::drawForeground(QPainter *painter, const QRectF &rect)

Zeichnet den Vordergrund der Szene mit painter, nachdem der Hintergrund und alle Elemente gezeichnet wurden. Implementieren Sie diese Funktion neu, um einen benutzerdefinierten Vordergrund für diese Ansicht zu erstellen.

Wenn Sie nur eine Farbe, eine Textur oder einen Farbverlauf für den Vordergrund definieren wollen, können Sie stattdessen setForegroundBrush() aufrufen.

Alle Malvorgänge werden in Szenekoordinaten durchgeführt. rect ist das freigelegte Rechteck.

Die Standardimplementierung füllt rect mit dem foregroundBrush der Ansicht. Wenn kein solcher Pinsel definiert ist (die Vorgabe), wird stattdessen die Funktion drawForeground() der Szene aufgerufen.

Siehe auch drawBackground() und QGraphicsScene::drawForeground().

[override virtual protected] void QGraphicsView::dropEvent(QDropEvent *event)

Reimplements: QAbstractScrollArea::dropEvent(QDropEvent *event).

void QGraphicsView::ensureVisible(const QRectF &rect, int xmargin = 50, int ymargin = 50)

Rollt den Inhalt des Ansichtsfensters so, dass das Szenenrechteck rect sichtbar ist, wobei die Ränder durch xmargin und ymargin in Pixeln angegeben werden. Wenn das angegebene Rechteck nicht erreicht werden kann, wird der Inhalt an die nächste gültige Position gerollt. Der Standardwert für beide Ränder ist 50 Pixel.

Siehe auch centerOn().

void QGraphicsView::ensureVisible(const QGraphicsItem *item, int xmargin = 50, int ymargin = 50)

Dies ist eine überladene Funktion.

Rollt den Inhalt des Ansichtsfensters so, dass die Mitte des Elements item sichtbar ist, wobei die Ränder durch xmargin und ymargin in Pixeln angegeben werden. Wenn der angegebene Punkt nicht erreicht werden kann, wird der Inhalt an die nächste gültige Position gerollt. Der Standardwert für beide Ränder ist 50 Pixel.

Siehe auch centerOn().

void QGraphicsView::ensureVisible(qreal x, qreal y, qreal w, qreal h, int xmargin = 50, int ymargin = 50)

Dies ist eine überladene Funktion.

Diese Funktion wird aus Gründen der Bequemlichkeit bereitgestellt. Sie entspricht dem Aufruf von ensureVisible(QRectF(x, y, w, h), xmargin, ymargin).

[override virtual protected] bool QGraphicsView::event(QEvent *event)

Reimplements: QAbstractScrollArea::event(QEvent *Event).

void QGraphicsView::fitInView(const QRectF &rect, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio)

Skaliert die Ansichtsmatrix und verschiebt die Bildlaufleisten, um sicherzustellen, dass das Szenenrechteck rect in das Ansichtsfenster passt. rect muss sich innerhalb des Szenenrechtecks befinden; andernfalls kann fitInView() nicht garantieren, dass das gesamte Rechteck sichtbar ist.

Diese Funktion behält die Rotation, Translation oder Scherung der Ansicht bei. Die Ansicht wird entsprechend aspectRatioMode skaliert. rect wird in der Ansicht zentriert, wenn sie nicht genau passt.

Es ist üblich, fitInView() innerhalb einer Neuimplementierung von resizeEvent() aufzurufen, um sicherzustellen, dass die gesamte Szene oder Teile der Szene automatisch skaliert werden, um sich der neuen Größe des Ansichtsfensters anzupassen, wenn die Größe der Ansicht geändert wird. Beachten Sie jedoch, dass der Aufruf von fitInView() innerhalb von resizeEvent() zu einer unerwünschten Rekursion der Größenänderung führen kann, wenn die neue Transformation den automatischen Zustand der Bildlaufleisten umschaltet. Um dies zu verhindern, können Sie die Bildlaufleistenrichtlinien auf immer ein oder immer aus stellen (siehe horizontalScrollBarPolicy() und verticalScrollBarPolicy()).

Wenn rect leer ist oder wenn das Ansichtsfenster zu klein ist, bewirkt diese Funktion nichts.

Siehe auch setTransform(), ensureVisible(), und centerOn().

void QGraphicsView::fitInView(const QGraphicsItem *item, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio)

Dies ist eine überladene Funktion.

Stellt sicher, dass item eng in die Ansicht passt und skaliert die Ansicht gemäß aspectRatioMode.

Siehe auch ensureVisible() und centerOn().

void QGraphicsView::fitInView(qreal x, qreal y, qreal w, qreal h, Qt::AspectRatioMode aspectRatioMode = Qt::IgnoreAspectRatio)

Dies ist eine überladene Funktion.

Diese Komfortfunktion entspricht dem Aufruf von fitInView(QRectF(x, y, w, h), aspectRatioMode).

Siehe auch ensureVisible() und centerOn().

[override virtual protected] void QGraphicsView::focusInEvent(QFocusEvent *event)

Reimplements: QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] bool QGraphicsView::focusNextPrevChild(bool next)

Reimplements: QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QGraphicsView::focusOutEvent(QFocusEvent *event)

Reimplements: QWidget::focusOutEvent(QFocusEvent *event).

[override virtual protected] void QGraphicsView::inputMethodEvent(QInputMethodEvent *event)

Reimplements: QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QGraphicsView::inputMethodQuery(Qt::InputMethodQuery query) const

Reimplements: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

[slot] void QGraphicsView::invalidateScene(const QRectF &rect = QRectF(), QGraphicsScene::SceneLayers layers = QGraphicsScene::AllLayers)

Macht layers innerhalb von rect ungültig und plant ein erneutes Zeichnen. rect befindet sich in Szenenkoordinaten. Alle zwischengespeicherten Inhalte für layers innerhalb von rect werden bedingungslos ungültig gemacht und neu gezeichnet.

Sie können diese Funktion aufrufen, um QGraphicsView über Änderungen des Hintergrunds oder des Vordergrunds der Szene zu informieren. Sie wird häufig für Szenen mit kachelbasierten Hintergründen verwendet, um Änderungen mitzuteilen, wenn QGraphicsView das Caching des Hintergrunds aktiviert hat.

Beachten Sie, dass QGraphicsView derzeit nur Hintergrund-Caching unterstützt (siehe QGraphicsView::CacheBackground). Diese Funktion ist äquivalent zum Aufruf von update(), wenn eine andere Ebene als QGraphicsScene::BackgroundLayer übergeben wird.

Siehe auch QGraphicsScene::invalidate() und update().

bool QGraphicsView::isTransformed() const

Gibt true zurück, wenn die Ansicht transformiert ist (d.h. eine nicht-identische Transformation zugewiesen wurde oder die Bildlaufleisten angepasst wurden).

Siehe auch setTransform(), horizontalScrollBar(), und verticalScrollBar().

QGraphicsItem *QGraphicsView::itemAt(const QPoint &pos) const

Gibt das Element an der Position pos zurück, die in Ansichtskoordinaten angegeben ist. Befinden sich mehrere Elemente an dieser Position, gibt diese Funktion das oberste Element zurück.

Beispiel:

void CustomView::mousePressEvent(QMouseEvent *event) { if (QGraphicsItem *item = itemAt(event->pos())) {        qDebug() << "You clicked on item" << item;
    } sonst {        qDebug("You didn't click on an item.");
    } }

Siehe auch items() und Sorting.

QGraphicsItem *QGraphicsView::itemAt(int x, int y) const

Dies ist eine überladene Funktion.

Diese Funktion wird aus Gründen der Bequemlichkeit bereitgestellt. Sie ist gleichbedeutend mit dem Aufruf von itemAt(QPoint(x, y)).

QList<QGraphicsItem *> QGraphicsView::items() const

Gibt eine Liste aller Elemente in der zugehörigen Szene in absteigender Stapelreihenfolge zurück (d. h. das erste Element in der zurückgegebenen Liste ist das oberste Element).

Siehe auch QGraphicsScene::items() und Sorting.

QList<QGraphicsItem *> QGraphicsView::items(const QPoint &pos) const

Gibt eine Liste aller Elemente an der Position pos in der Ansicht zurück. Die Elemente werden in absteigender Stapelreihenfolge aufgelistet (d. h. das erste Element in der Liste ist das oberste Element und das letzte Element ist das unterste Element). pos ist in Ansichtskoordinaten.

Diese Funktion wird am häufigsten innerhalb von Mausereignishandlern in einer Unterklasse in QGraphicsView aufgerufen. pos ist in untransformierten Viewport-Koordinaten, genau wie QMouseEvent::pos().

void CustomView::mousePressEvent(QMouseEvent *event){
    qDebug() << "There are" << items(event->pos()).size()
            << "Elemente an Position"<< mapToScene(event->pos()); }

Siehe auch QGraphicsScene::items() und Sorting.

QList<QGraphicsItem *> QGraphicsView::items(int x, int y) const

Diese Funktion wird der Einfachheit halber bereitgestellt. Sie ist gleichbedeutend mit dem Aufruf von items(QPoint(x, y)).

QList<QGraphicsItem *> QGraphicsView::items(int x, int y, int w, int h, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

Diese Komfortfunktion ist gleichbedeutend mit dem Aufruf von items(QRectF(x, y, w, h), mode).

QList<QGraphicsItem *> QGraphicsView::items(const QPainterPath &path, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

Dies ist eine überladene Funktion.

Gibt eine Liste aller Elemente zurück, die, abhängig von mode, entweder in path enthalten sind oder sich mit schneiden. path ist in Ansichtsfenster-Koordinaten.

Der Standardwert für mode ist Qt::IntersectsItemShape; es werden alle Elemente zurückgegeben, deren exakte Form sich mit path überschneidet oder von enthalten wird.

Siehe auch itemAt(), items(), mapToScene(), und Sorting.

QList<QGraphicsItem *> QGraphicsView::items(const QPolygon &polygon, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

Dies ist eine überladene Funktion.

Gibt eine Liste aller Elemente zurück, die, abhängig von mode, entweder in polygon enthalten sind oder sich mit schneiden. polygon ist in Ansichtsfenster-Koordinaten.

Der Standardwert für mode ist Qt::IntersectsItemShape; es werden alle Elemente zurückgegeben, deren exakte Form sich mit polygon überschneidet oder von diesem enthalten wird.

Die Elemente werden in absteigender Stapelreihenfolge sortiert (d.h. das erste Element in der zurückgegebenen Liste ist das oberste Element).

Siehe auch itemAt(), items(), mapToScene(), und Sorting.

QList<QGraphicsItem *> QGraphicsView::items(const QRect &rect, Qt::ItemSelectionMode mode = Qt::IntersectsItemShape) const

Dies ist eine überladene Funktion.

Gibt eine Liste aller Elemente zurück, die, abhängig von mode, entweder in rect enthalten sind oder sich mit schneiden. rect ist in Ansichtsfenster-Koordinaten.

Der Standardwert für mode ist Qt::IntersectsItemShape; es werden alle Elemente zurückgegeben, deren exakte Form sich mit rect überschneidet oder von diesem enthalten wird.

Die Elemente werden in absteigender Stapelreihenfolge sortiert (d.h. das erste Element in der zurückgegebenen Liste ist das oberste Element).

Siehe auch itemAt(), items(), mapToScene(), und Sorting.

[override virtual protected] void QGraphicsView::keyPressEvent(QKeyEvent *event)

Reimplements: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

[override virtual protected] void QGraphicsView::keyReleaseEvent(QKeyEvent *event)

Reimplements: QWidget::keyReleaseEvent(QKeyEvent *event).

QPainterPath QGraphicsView::mapFromScene(const QPainterPath &path) const

Gibt den Szenenkoordinaten-Malerpfad path zu einem Viewport-Koordinaten-Malerpfad zurück.

Siehe auch mapToScene().

QPoint QGraphicsView::mapFromScene(const QPointF &point) const

Gibt die Szenenkoordinaten point in Ansichtsfenster-Koordinaten zurück.

Siehe auch mapToScene().

QPolygon QGraphicsView::mapFromScene(const QPolygonF &polygon) const

Gibt das Szenenkoordinatenpolygon polygon zu einem Ansichtsfenster-Koordinatenpolygon zurück.

Siehe auch mapToScene().

QPolygon QGraphicsView::mapFromScene(const QRectF &rect) const

Gibt das Szenenrechteck rect zu einem Ansichtsfenster-Koordinatenpolygon zurück.

Siehe auch mapToScene().

QPoint QGraphicsView::mapFromScene(qreal x, qreal y) const

Diese Funktion wird aus Gründen der Bequemlichkeit bereitgestellt. Sie ist gleichbedeutend mit dem Aufruf von mapFromScene(QPointF(x, y)).

QPolygon QGraphicsView::mapFromScene(qreal x, qreal y, qreal w, qreal h) const

Diese Funktion wird der Einfachheit halber bereitgestellt. Sie entspricht dem Aufruf von mapFromScene(QRectF(x, y, w, h)).

QPainterPath QGraphicsView::mapToScene(const QPainterPath &path) const

Gibt den Viewport-Malerpfad path zurück, der auf einen Szenenkoordinaten-Malerpfad abgebildet ist.

Siehe auch mapFromScene().

QPointF QGraphicsView::mapToScene(const QPoint &point) const

Gibt die Koordinaten des Ansichtsfensters point zurück, die auf Szenenkoordinaten abgebildet sind.

Hinweis: Es kann nützlich sein, das gesamte Rechteck, das von dem Pixel auf point abgedeckt wird, anstelle des Punktes selbst abzubilden. Zu diesem Zweck können Sie mapToScene(QRect(point, QSize(2, 2))) aufrufen.

Siehe auch mapFromScene().

QPolygonF QGraphicsView::mapToScene(const QPolygon &polygon) const

Gibt das Polygon des Ansichtsfensters polygon zurück, das auf ein Szenenkoordinatenpolygon abgebildet ist.

Siehe auch mapFromScene().

QPolygonF QGraphicsView::mapToScene(const QRect &rect) const

Gibt das Viewport-Rechteck rect zurück, das auf ein Szenenkoordinaten-Polygon abgebildet ist.

Siehe auch mapFromScene().

QPointF QGraphicsView::mapToScene(int x, int y) const

Diese Funktion wird der Einfachheit halber bereitgestellt. Sie ist gleichbedeutend mit dem Aufruf von mapToScene(QPoint(x, y)).

QPolygonF QGraphicsView::mapToScene(int x, int y, int w, int h) const

Diese Funktion wird der Einfachheit halber bereitgestellt. Sie entspricht dem Aufruf von mapToScene(QRect(x, y, w, h)).

[override virtual protected] void QGraphicsView::mouseDoubleClickEvent(QMouseEvent *event)

Reimplements: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

[override virtual protected] void QGraphicsView::mouseMoveEvent(QMouseEvent *event)

Reimplements: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

[override virtual protected] void QGraphicsView::mousePressEvent(QMouseEvent *event)

Reimplements: QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

[override virtual protected] void QGraphicsView::mouseReleaseEvent(QMouseEvent *event)

Reimplements: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

[override virtual protected] void QGraphicsView::paintEvent(QPaintEvent *event)

Reimplements: QAbstractScrollArea::paintEvent(QPaintEvent *event).

void QGraphicsView::render(QPainter *painter, const QRectF &target = QRectF(), const QRect &source = QRect(), Qt::AspectRatioMode aspectRatioMode = Qt::KeepAspectRatio)

Rendert das source Rect, das in Ansichtskoordinaten vorliegt, aus der Szene in target, das in Malgerätkoordinaten vorliegt, unter Verwendung von painter. Diese Funktion ist nützlich, um den Inhalt der Ansicht auf ein Malgerät wie QImage zu übertragen (z.B. um einen Screenshot zu machen) oder um mit QPrinter zu drucken. Ein Beispiel:

QGraphicsScene scene;
scene.addItem(...
...

QGraphicsView view(&scene);
view.show();
...

QPrinter printer(QPrinter::HighResolution);
printer.setPageSize(QPrinter::A4);
QPainter painter(&printer);

// print, fitting the viewport contents into a full page
view.render(&painter);

// print the upper half of the viewport into the lower.
// half of the page.
QRect viewport = view.viewport()->rect();
view.render(&painter,
            QRectF(0, printer.height() / 2,
                   printer.width(), printer.height() / 2),
            viewport.adjusted(0, 0, 0, -viewport.height() / 2));

Wenn source ein Null-Rect ist, wird diese Funktion viewport()->rect() verwenden, um zu bestimmen, was gezeichnet werden soll. Wenn target ein Null-Rect ist, werden die vollen Dimensionen des Malgeräts von painter verwendet (z.B. für einen QPrinter, die Seitengröße).

Der Inhalt des Quell-Rects wird gemäß aspectRatioMode transformiert, um in das Ziel-Rect zu passen. Standardmäßig wird das Seitenverhältnis beibehalten, und source wird so skaliert, dass es in target passt.

Siehe auch QGraphicsScene::render().

void QGraphicsView::resetCachedContent()

Setzt alle zwischengespeicherten Inhalte zurück. Durch den Aufruf dieser Funktion wird der Cache von QGraphicsView gelöscht. Wenn der aktuelle Cachemodus CacheNone ist, bewirkt diese Funktion nichts.

Diese Funktion wird automatisch für Sie aufgerufen, wenn sich die Eigenschaften backgroundBrush oder QGraphicsScene::backgroundBrush ändern; Sie müssen diese Funktion nur aufrufen, wenn Sie QGraphicsScene::drawBackground() oder QGraphicsView::drawBackground() neu implementiert haben, um einen benutzerdefinierten Hintergrund zu zeichnen, und einen vollständigen Neuaufbau auslösen müssen.

Siehe auch cacheMode().

void QGraphicsView::resetTransform()

Setzt die Ansichtstransformation auf die Identitätsmatrix zurück.

Siehe auch transform() und setTransform().

[override virtual protected] void QGraphicsView::resizeEvent(QResizeEvent *event)

Reimplements: QAbstractScrollArea::resizeEvent(QResizeEvent *event).

void QGraphicsView::rotate(qreal angle)

Dreht die aktuelle Ansichtstransformation angle im Uhrzeigersinn.

Siehe auch setTransform(), transform(), scale(), shear(), und translate().

[signal] void QGraphicsView::rubberBandChanged(QRect rubberBandRect, QPointF fromScenePoint, QPointF toScenePoint)

Dieses Signal wird ausgegeben, wenn das Gummiband-Rect geändert wird. Das Viewport Rect wird mit rubberBandRect angegeben. Die Start- und Endposition für das Ziehen werden in Szenenpunkten mit fromScenePoint und toScenePoint angegeben.

Wenn die Gummibandauswahl endet, wird dieses Signal mit Nullwerten ausgegeben.

Siehe auch rubberBandRect().

QRect QGraphicsView::rubberBandRect() const

Diese Funktion gibt den aktuellen Gummibandbereich (in Viewport-Koordinaten) zurück, wenn der Benutzer gerade eine Elementauswahl mit Gummiband vornimmt. Wenn der Benutzer das Gummiband nicht benutzt, gibt diese Funktion (ein Null) QRectF() zurück.

Beachten Sie, dass ein Teil dieser QRect außerhalb des visuellen Darstellungsbereichs liegen kann. Er kann z. B. negative Werte enthalten.

Siehe auch rubberBandSelectionMode und rubberBandChanged().

void QGraphicsView::scale(qreal sx, qreal sy)

Skaliert die aktuelle Ansichtstransformation um (sx, sy).

Siehe auch setTransform(), transform(), rotate(), shear(), und translate().

QGraphicsScene *QGraphicsView::scene() const

Gibt einen Zeiger auf die Szene zurück, die derzeit in der Ansicht visualisiert wird. Wenn derzeit keine Szene visualisiert wird, wird nullptr zurückgegeben.

Siehe auch setScene().

[override virtual protected] void QGraphicsView::scrollContentsBy(int dx, int dy)

Reimplements: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

void QGraphicsView::setOptimizationFlag(QGraphicsView::OptimizationFlag flag, bool enabled = true)

Aktiviert flag, wenn enabled wahr ist; andernfalls wird flag deaktiviert.

Siehe auch optimizationFlags.

void QGraphicsView::setRenderHint(QPainter::RenderHint hint, bool enabled = true)

Wenn enabled true ist, ist der Rendering-Hinweis hint aktiviert; andernfalls ist er deaktiviert.

Siehe auch renderHints.

void QGraphicsView::setScene(QGraphicsScene *scene)

Setzt die aktuelle Szene auf scene. Wenn scene bereits angezeigt wird, bewirkt diese Funktion nichts.

Wenn eine Szene auf eine Ansicht gesetzt wird, wird das Signal QGraphicsScene::changed() automatisch mit dem updateScene()-Slot dieser Ansicht verbunden, und die Bildlaufleisten der Ansicht werden an die Größe der Szene angepasst.

Die Ansicht übernimmt nicht das Eigentum an scene.

Siehe auch scene().

void QGraphicsView::setTransform(const QTransform &matrix, bool combine = false)

Setzt die aktuelle Transformationsmatrix der Ansicht auf matrix.

Wenn combine wahr ist, wird matrix mit der aktuellen Matrix kombiniert; andernfalls ersetzt matrix die aktuelle Matrix. combine ist standardmäßig falsch.

Die Transformationsmatrix transformiert die Szene in Ansichtskoordinaten. Bei Verwendung der Standardtransformation, die durch die Identitätsmatrix bereitgestellt wird, entspricht ein Pixel in der Ansicht einer Einheit in der Szene (z. B. wird ein rechteckiges Objekt von 10x10 mit 10x10 Pixeln in der Ansicht gezeichnet). Bei Anwendung einer 2x2-Skalierungsmatrix wird die Szene im Verhältnis 1:2 gezeichnet (z. B. wird ein rechteckiges Element von 10x10 dann mit 20x20 Pixeln in der Ansicht gezeichnet).

Beispiel:

QGraphicsScene scene;
scene.addText("GraphicsView rotated clockwise");

QGraphicsView view(&scene);
view.rotate(90); // the text is rendered with a 90 degree clockwise rotation
view.show();

Um die Interaktion mit Elementen zu vereinfachen, die eine transformierte Ansicht verwenden, bietet QGraphicsView die Funktionen mapTo... und mapFrom... an, die zwischen den Koordinaten der Szene und der Ansicht übersetzen können. Sie können zum Beispiel mapToScene() aufrufen, um eine Ansichtskoordinate auf eine Fließkomma-Szenekoordinate abzubilden, oder mapFromScene(), um von Fließkomma-Szenekoordinaten auf Ansichtskoordinaten abzubilden.

Siehe auch transform(), resetTransform(), rotate(), scale(), shear(), und translate().

[override virtual protected slot] void QGraphicsView::setupViewport(QWidget *widget)

Reimplements: QAbstractScrollArea::setupViewport(QWidget *viewport).

Dieser Slot wird von QAbstractScrollArea aufgerufen, nachdem setViewport() aufgerufen wurde. Reimplementieren Sie diese Funktion in einer Unterklasse von QGraphicsView, um das neue Viewport widget zu initialisieren, bevor es verwendet wird.

Siehe auch setViewport().

void QGraphicsView::shear(qreal sh, qreal sv)

Schert die aktuelle Ansichtstransformation um (sh, sv).

Siehe auch setTransform(), transform(), rotate(), scale(), und translate().

[override virtual protected] void QGraphicsView::showEvent(QShowEvent *event)

Reimplements: QWidget::showEvent(QShowEvent *event).

[override virtual] QSize QGraphicsView::sizeHint() const

Reimplements: QAbstractScrollArea::sizeHint() const.

QTransform QGraphicsView::transform() const

Gibt die aktuelle Transformationsmatrix für die Ansicht zurück. Wenn keine aktuelle Transformation gesetzt ist, wird die Identitätsmatrix zurückgegeben.

Siehe auch setTransform(), rotate(), scale(), shear(), und translate().

void QGraphicsView::translate(qreal dx, qreal dy)

Übersetzt die aktuelle Ansichtstransformation durch (dx, dy).

Siehe auch setTransform(), transform(), rotate(), und shear().

[slot] void QGraphicsView::updateScene(const QList<QRectF> &rects)

Plant eine Aktualisierung der Szenenrechtecke rects.

Siehe auch QGraphicsScene::changed().

[slot] void QGraphicsView::updateSceneRect(const QRectF &rect)

Informiert QGraphicsView, dass sich das Szenenrect der Szene geändert hat. rect ist das neue Szenenrect. Wenn die Ansicht bereits ein explizit festgelegtes Szenenrect hat, bewirkt diese Funktion nichts.

Siehe auch sceneRect und QGraphicsScene::sceneRectChanged().

[override virtual protected] bool QGraphicsView::viewportEvent(QEvent *event)

Reimplements: QAbstractScrollArea::viewportEvent(QEvent *Event).

QTransform QGraphicsView::viewportTransform() const

Gibt eine Matrix zurück, die die Koordinaten der Szene auf die Koordinaten des Ansichtsfensters abbildet.

Siehe auch mapToScene() und mapFromScene().

[override virtual protected] void QGraphicsView::wheelEvent(QWheelEvent *event)

Reimplements: QAbstractScrollArea::wheelEvent(QWheelEvent *e).