QGraphicsView Class

Dokumentation zu den Mitgliedsfunktionen

QGraphicsView::QGraphicsView(QWidget *parent = nullptr)

Erstellt ein `QGraphicsView`-Objekt. ` parent ` wird an den Konstruktor von ` QWidget` übergeben.

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

Erstellt ein `QGraphicsView`-Objekt und legt die darzustellende Szene auf ` scene` fest. ` parent ` wird an den Konstruktor von ` QWidget` übergeben.

[virtual noexcept] QGraphicsView::~QGraphicsView()

Löst das Objekt „ QGraphicsView “ auf.

void QGraphicsView::centerOn(const QPointF &pos)

Blättert den Inhalt des Ansichtsbereichs, um sicherzustellen, dass der Szenenkoordinaten pos, in der Ansicht zentriert ist.

Da pos eine Gleitkommakoordinate ist und die Bildlaufleisten mit ganzzahligen Koordinaten arbeiten, handelt es sich bei der Zentrierung lediglich um eine Annäherung.

Siehe auch ` ensureVisible()`.

void QGraphicsView::centerOn(const QGraphicsItem *item)

Blättert den Inhalt des Ansichtsbereichs, um sicherzustellen, dass „ item “ in der Ansicht zentriert ist.

Siehe auch ` ensureVisible()`.

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

Diese Funktion dient der Vereinfachung. Sie entspricht dem Aufruf von centerOn(QPointF(x, y)).

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

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

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

Umsetzt: ` QAbstractScrollArea::dragEnterEvent` (`QDragEnterEvent *event`).

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

Implementiert: ` QAbstractScrollArea::dragLeaveEvent` (`QDragLeaveEvent *event`).

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

Umsetzt: ` QAbstractScrollArea::dragMoveEvent` (`QDragMoveEvent *event`).

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

Zeichnet den Hintergrund der Szene mithilfe von ` painter`, bevor Elemente und der Vordergrund gezeichnet werden. Implementieren Sie diese Funktion neu, um einen benutzerdefinierten Hintergrund für diese Ansicht bereitzustellen.

Wenn Sie lediglich eine Farbe, eine Textur oder einen Farbverlauf für den Hintergrund festlegen möchten, können Sie stattdessen ` setBackgroundBrush()` aufrufen.

Das Zeichnen erfolgt ausschließlich in Szenenkoordinaten. ` rect ` ist das sichtbare Rechteck.

Die Standardimplementierung füllt ` rect ` unter Verwendung des ` backgroundBrush` der Ansicht. Ist kein solcher Pinsel definiert (Standard), 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 mithilfe von ` painter`, nachdem der Hintergrund und alle Elemente gezeichnet wurden. Implementieren Sie diese Funktion neu, um einen benutzerdefinierten Vordergrund für diese Ansicht bereitzustellen.

Wenn Sie lediglich eine Farbe, eine Textur oder einen Farbverlauf für den Vordergrund festlegen möchten, können Sie stattdessen ` setForegroundBrush()` aufrufen.

Das Zeichnen erfolgt ausschließlich in Szenenkoordinaten. ` rect ` ist das sichtbare Rechteck.

Die Standardimplementierung füllt ` rect ` unter Verwendung des ` foregroundBrush` der Ansicht. Ist kein solcher Pinsel definiert (Standardeinstellung), wird stattdessen die Funktion `drawForeground()` der Szene aufgerufen.

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

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

Implementiert: ` QAbstractScrollArea::dropEvent(QDropEvent *event)`.

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

Blättert den Inhalt des Ansichtsbereichs so, dass das Szenenrechteck rect sichtbar ist, wobei die Ränder in Pixeln durch xmargin und ymargin festgelegt werden. Wenn das angegebene Rechteck nicht erreicht werden kann, wird der Inhalt zur nächstgelegenen gültigen Position geblättert. Der Standardwert für beide Ränder beträgt 50 Pixel.

Siehe auch centerOn().

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

Blättert den Inhalt des Ansichtsbereichs so, dass der Mittelpunkt von `item item ` sichtbar ist, wobei die Ränder in Pixeln durch ` xmargin ` und ` ymargin` festgelegt werden. Kann der angegebene Punkt nicht erreicht werden, wird der Inhalt zur nächstgelegenen gültigen Position geblättert. Der Standardwert für beide Ränder beträgt 50 Pixel.

Siehe auch centerOn().

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

Diese Funktion dient der Vereinfachung. Sie entspricht dem Aufruf von `ensureVisible(QRectF(x, y, w, h), xmargin, ymargin)`.

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

Umsetzt: ` 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 vollständig in den Ansichtsbereich passt. rect muss sich innerhalb des Szenenrechtecks befinden; andernfalls kann fitInView() nicht garantieren, dass das gesamte Rechteck sichtbar ist.

Diese Funktion behält die Drehung, Verschiebung oder Scherung der Ansicht bei. Die Ansicht wird entsprechend aspectRatioMode skaliert. rect wird in der Ansicht zentriert, wenn es nicht genau hineinpasst.

Es ist üblich, `fitInView()` aus einer Neuimplementierung von ` resizeEvent()` heraus aufzurufen, um sicherzustellen, dass die gesamte Szene oder Teile davon automatisch skaliert werden, um sich der neuen Größe des Ansichtsfensters anzupassen, wenn die Ansicht in der Größe verändert wird. Beachten Sie jedoch, dass der Aufruf von `fitInView()` innerhalb von ` resizeEvent()` zu einer unerwünschten Rekursion bei der Größenanpassung führen kann, wenn die neue Transformation den automatischen Status der Bildlaufleisten umschaltet. Sie können die Bildlaufleisten-Richtlinien auf „immer ein“ oder „immer aus“ umschalten, um dies zu verhindern (siehe ` horizontalScrollBarPolicy()` und ` verticalScrollBarPolicy()`).

Wenn ` rect ` leer ist oder der Viewport zu klein ist, führt diese Funktion keine Aktion aus.

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

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

Stellt sicher, dass „ item “ genau in die Ansicht passt, und skaliert die Ansicht entsprechend „ aspectRatioMode “.

Siehe auch ensureVisible() und centerOn().

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

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)

Implementiert: ` QWidget::focusInEvent(QFocusEvent *event)`.

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

Implementiert: ` QWidget::focusNextPrevChild` (bool next).

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

Implementiert: ` QWidget::focusOutEvent(QFocusEvent *event)`.

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

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

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

Implementiert neu: ` 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 eine Neuzeichnung an. „ rect “ liegt in Szenenkoordinaten vor. 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 am Hintergrund oder Vordergrund der Szene zu informieren. Sie wird häufig bei Szenen mit kachelbasierten Hintergründen verwendet, um Änderungen zu melden, wenn QGraphicsView das Hintergrund-Caching aktiviert hat.

Beachten Sie, dass QGraphicsView derzeit nur das Hintergrund-Caching unterstützt (siehe QGraphicsView::CacheBackground). Diese Funktion entspricht dem Aufruf von update(), wenn eine beliebige Ebene außer QGraphicsScene::BackgroundLayer übergeben wird.

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

bool QGraphicsView::isTransformed() const

Gibt „ true “ zurück, wenn die Ansicht transformiert wurde (d. h., wenn eine Nicht-Identitäts-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, wobei es sich um Koordinaten im Ansichtsfenster handelt. 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;
    } else {
        qDebug("You didn't click on an item.");
    }
}

Siehe auch items() und Sorting.

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

Diese Funktion dient der Vereinfachung. Sie entspricht dem Aufruf von itemAt(QPoint(x, y)).

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

Gibt eine Liste aller Elemente 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 Ansichtsbereichskoordinaten angegeben.

Diese Funktion wird am häufigsten aus Mausereignis-Handlern in einer Unterklasse von ` QGraphicsView` aufgerufen. ` pos ` ist in untransformierten Viewport-Koordinaten angegeben, genau wie bei ` QMouseEvent::position()`.

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

Siehe auch QGraphicsScene::items() und Sorting.

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

Diese Funktion dient der Vereinfachung. Sie entspricht 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 entspricht dem Aufruf von `items(QRectF(x, y, w, h), mode)`.

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

Gibt eine Liste aller Elemente zurück, die – abhängig von ` mode` – entweder von ` path` enthalten werden oder sich mit diesem überschneiden. ` path ` ist in Viewport-Koordinaten angegeben.

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

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

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

Gibt eine Liste aller Elemente zurück, die – abhängig von ` mode` – entweder von ` polygon` enthalten werden oder sich mit diesem überschneiden. ` polygon ` ist in Viewport-Koordinaten angegeben.

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

Die Elemente werden nach 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

Gibt eine Liste aller Elemente zurück, die – abhängig von ` mode` – entweder in ` rect` enthalten sind oder sich mit diesem überschneiden. ` rect ` ist in Viewport-Koordinaten angegeben.

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

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)

Implementiert: ` QAbstractScrollArea::keyPressEvent(QKeyEvent *e)`.

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

Implementiert: ` QWidget::keyReleaseEvent(QKeyEvent *event)`.

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

Konvertiert den Koordinaten-Painter-Pfad „ path “ aus der Szene in einen Koordinaten-Painter-Pfad im Ansichtsfenster.

Siehe auch mapToScene().

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

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

Siehe auch „ mapToScene()“.

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

Konvertiert das Polygon „ polygon “ aus Szenenkoordinaten in ein Polygon aus Ansichtsfensterkoordinaten.

Siehe auch ` mapToScene()`.

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

Gibt das Szenenrechteck „ rect “ als Polygon mit Viewport-Koordinaten zurück.

Siehe auch mapToScene().

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

Diese Funktion dient der Vereinfachung. Sie entspricht dem Aufruf von `mapFromScene(QPointF(x, y))`.

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

Diese Funktion dient der Vereinfachung. Sie entspricht dem Aufruf von `mapFromScene(QRectF(x, y, w, h))`.

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

Gibt den Viewport-Painter-Pfad path zurück, der auf einen Painter-Pfad im Szenenkoordinatensystem abgebildet ist.

Siehe auch mapFromScene().

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

Gibt die auf Szenenkoordinaten abgebildete Viewport-Koordinaten point zurück.

Hinweis: Es kann sinnvoll sein, statt des Punktes selbst das gesamte Rechteck abzubilden, das vom Pixel an der Position point abgedeckt wird. Dazu können Sie die Funktion `mapToScene(QRect(point, QSize(2, 2))` aufrufen.

Siehe auch mapFromScene().

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

Gibt das Viewport-Polygon polygon zurück, das auf ein Polygon im Szenenkoordinatensystem abgebildet wurde.

Siehe auch ` mapFromScene()`.

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

Gibt das Viewport-Rechteck „ rect “ zurück, das einem Polygon im Szenenkoordinatensystem zugeordnet ist.

Siehe auch mapFromScene().

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

Diese Funktion dient der Vereinfachung. Sie entspricht dem Aufruf von `mapToScene(QPoint(x, y))`.

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

Diese Funktion dient der Vereinfachung. Sie entspricht dem Aufruf von `mapToScene(QRect(x, y, w, h))`.

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

Implementiert: ` QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)`.

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

Implementiert neu: ` QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)`.

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

Implementiert: ` QAbstractScrollArea::mousePressEvent(QMouseEvent *e)`.

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

Implementiert: ` QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)`.

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

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

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

Wandelt das Rechteck ` source ` aus der Szene, das in Ansichtskoordinaten vorliegt, mithilfe von ` painter` in das Rechteck ` target` um, das in Koordinaten des Zeichen-Geräts vorliegt. Diese Funktion ist nützlich, um den Inhalt der Ansicht auf einem Zeichen-Gerät wie beispielsweise einem ` QImage ` zu erfassen (z. B. um einen Screenshot zu erstellen) oder um auf `QPrinter` zu drucken. Beispiel:

QGraphicsScene scene;
scene.addItem(someItem);
//...

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

QPrinter printer(QPrinter::HighResolution);
printer.setDocName("Example");
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-Rechteck ist, verwendet diese Funktion „ viewport()->rect()“, um zu bestimmen, was gezeichnet werden soll. Wenn „ target “ ein Null-Rechteck ist, werden die vollen Abmessungen des Zeichenbereichs von „ painter “ (z. B. bei einem QPrinter die Seitengröße) verwendet.

Der Inhalt des Quell-Rechtseckes wird gemäß aspectRatioMode transformiert, um in das Ziel-Rechtseck 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 “ geleert. Wenn der aktuelle Cache-Modus „ CacheNone “ ist, hat diese Funktion keine Auswirkung.

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 die Methoden „ QGraphicsScene::drawBackground()“ oder „ QGraphicsView::drawBackground()“ neu implementiert haben, um einen benutzerdefinierten Hintergrund zu zeichnen, und eine vollständige Neuzeichnung auslösen müssen.

Siehe auch ` cacheMode()`.

void QGraphicsView::resetTransform()

Setzt die Ansichtstransformation auf die Einheitsmatrix zurück.

Siehe auch „ transform()“ und „ setTransform()“.

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

Implementiert: ` QAbstractScrollArea::resizeEvent(QResizeEvent *event)`.

void QGraphicsView::rotate(qreal angle)

Dreht die aktuelle Ansichtstransformation um angle Grad im Uhrzeigersinn.

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

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

Dieses Signal wird ausgelöst, wenn der Rechteckbereich des Gummibands geändert wird. Der Sichtbereich wird durch „ rubberBandRect “ festgelegt. Die Start- und Endposition des Ziehvorgangs werden in Szenenpunkten mit „ fromScenePoint “ und „ toScenePoint “ angegeben.

Wenn die Gummibandauswahl endet, wird dieses Signal mit Nullwerten ausgelöst.

Siehe auch rubberBandRect().

QRect QGraphicsView::rubberBandRect() const

Diese Funktion gibt den aktuellen Bereich des „Rubber Bands“ (in Viewport-Koordinaten) zurück, wenn der Benutzer gerade eine Elementauswahl mit dem „Rubber Band“ vornimmt. Wenn der Benutzer das „Rubber Band“ nicht verwendet, gibt diese Funktion (Null) QRectF() zurück.

Beachten Sie, dass ein Teil dieses „ QRect “ außerhalb des sichtbaren Ansichtsbereichs 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)

Implementiert: ` QAbstractScrollArea::scrollContentsBy(int dx, int dy)`.

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

Aktiviert „ flag “, wenn „ enabled “ auf „true“ gesetzt ist; andernfalls wird „ flag “ deaktiviert.

Siehe auch optimizationFlags.

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

Wenn „ enabled “ wahr ist, ist der Render-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, führt diese Funktion keine Aktion aus.

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

Die Ansicht übernimmt nicht die Eigentümerschaft an ` scene`.

Siehe auch ` scene()`.

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

Setzt die aktuelle Transformationsmatrix der Ansicht auf „ matrix “.

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

Die Transformationsmatrix wandelt die Szene in Ansichtskoordinaten um. Bei Verwendung der Standardtransformation, die durch die Einheitsmatrix bereitgestellt wird, entspricht ein Pixel in der Ansicht einer Einheit in der Szene (z. B. wird ein rechteckiges Element mit den Maßen 10x10 mit 10x10 Pixeln in der Ansicht gezeichnet). Wird eine 2x2-Skalierungsmatrix angewendet, wird die Szene im Verhältnis 1:2 gezeichnet (z. B. wird ein rechteckiges Element mit den Maßen 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 in einer transformierten Ansicht zu vereinfachen, stellt „ QGraphicsView “ die Funktionen „mapTo...“ und „mapFrom...“ bereit, die eine Umrechnung zwischen Szenen- und Ansichts-Koordinaten ermöglichen. So können Sie beispielsweise „ mapToScene()“ aufrufen, um eine Ansichts-Koordinate auf eine Fließkomma-Szenenkoordinate abzubilden, oder „ mapFromScene()“, um von Fließkomma-Szenenkoordinaten auf Ansichts-Koordinaten umzurechnen.

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

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

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

Dieser Slot wird von ` QAbstractScrollArea ` aufgerufen, nachdem ` setViewport()` aufgerufen wurde. Implementieren Sie diese Funktion in einer Unterklasse von ` QGraphicsView ` neu, um den neuen Viewport- widget zu initialisieren, bevor er verwendet wird.

Siehe auch setViewport().

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

Schneidet die aktuelle Ansichts-Transformation um (sh, sv) ab.

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

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

Implementiert: ` QWidget::showEvent(QShowEvent *event)`.

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

Implementiert erneut: QAbstractScrollArea::sizeHint() const.

QTransform QGraphicsView::transform() const

Gibt die aktuelle Transformationsmatrix für die Ansicht zurück. Ist keine aktuelle Transformation festgelegt, wird die Einheitsmatrix zurückgegeben.

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

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

Wandelt die aktuelle Ansichtstransformation um gemäß (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)

Benachrichtigt „ QGraphicsView “, dass sich das Szenenrechteck der Szene geändert hat. „ rect “ ist das neue Szenenrechteck. Wenn für die Ansicht bereits explizit ein Szenenrechteck festgelegt wurde, führt diese Funktion keine Aktion aus.

Siehe auch sceneRect und QGraphicsScene::sceneRectChanged().

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

Umsetzt: ` QAbstractScrollArea::viewportEvent(QEvent *event)`.

QTransform QGraphicsView::viewportTransform() const

Gibt eine Matrix zurück, die Szenenkoordinaten auf Ansichtsbereichskoordinaten abbildet.

Siehe auch „ mapToScene()“ und „ mapFromScene()“.

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

Umsetzt: ` QAbstractScrollArea::wheelEvent(QWheelEvent *e)`.