QGraphicsView Class

成员函数文档

QGraphicsView::QGraphicsView(QWidget *parent = nullptr)

创建一个 QGraphicsView。将 `parent ` 传递给 `QWidget` 的构造函数。

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

创建一个 QGraphicsView 并将其可视化场景设置为 `scene`。将 `parent ` 传递给 `QWidget` 的构造函数。

[virtual noexcept] QGraphicsView::~QGraphicsView()

销毁QGraphicsView 对象。

void QGraphicsView::centerOn(const QPointF &pos)

滚动视口中的内容，以确保场景坐标pos 位于视图中心。

由于pos 是一个浮点坐标，而滚动条操作的是整数坐标，因此居中效果仅为近似值。

另请参阅 ensureVisible()。

void QGraphicsView::centerOn(const QGraphicsItem *item)

滚动视口内容，以确保item 在视口内居中。

另请参阅 ensureVisible()。

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

提供此函数是为了方便使用。它等同于调用 centerOn(QPointF(x,y))。

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

重写了：QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e)。

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

重写了：QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event)。

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

重写了：QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)。

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

重写了：QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)。

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

在绘制任何项目和前景之前，使用painter 绘制场景的背景。重写此函数可为该视图提供自定义背景。

若您仅需为背景定义颜色、纹理或渐变，则可改调用 `setBackgroundBrush()`。

所有绘制操作均在场景坐标系中进行。rect 表示可见的矩形区域。

默认实现会使用视图的backgroundBrush 来填充rect 。如果未定义此类画笔（默认情况），则会调用场景的drawBackground()函数。

另请参阅 drawForeground() 和QGraphicsScene::drawBackground()。

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

在绘制完背景和所有项目之后，使用 `painter` 绘制场景的前景。重写此函数可为该视图提供自定义的前景。

若您仅需为前景定义颜色、纹理或渐变，则可改用setForegroundBrush()。

所有绘制操作均在场景坐标系中进行。rect 表示可绘制区域。

默认实现会使用视图的 `foregroundBrush` 来填充 `rect `。如果未定义此类画笔（默认情况），则会调用场景的 `drawForeground()` 函数。

另请参阅 drawBackground() 和QGraphicsScene::drawForeground()。

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

重写了：QAbstractScrollArea::dropEvent(QDropEvent *event)。

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

滚动视口内容，使场景矩形rect 处于可见状态，其边距以像素为单位，由xmargin 和ymargin 指定。如果无法到达指定的矩形位置，则将内容滚动到最近的有效位置。两个边距的默认值均为 50 像素。

另请参阅 centerOn()。

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

滚动视口内容，使项目item 的中心可见，其边距由xmargin 和ymargin 以像素为单位指定。如果无法到达指定的点，则将内容滚动到最近的有效位置。这两个边距的默认值均为 50 像素。

另请参阅 centerOn()。

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

提供此函数是为了方便使用。它相当于调用 ensureVisible(QRectF(x,y,w,h),xmargin,ymargin)。

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

重写了：QAbstractScrollArea::event(QEvent *event)。

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

对视图矩阵进行缩放，并调整滚动条，以确保场景矩形rect 完全位于视口内。rect 必须位于场景矩形内部；否则，fitInView() 无法保证整个矩形均处于可见状态。

此函数会保留视图的旋转、平移或剪切。视图将根据aspectRatioMode 进行缩放。如果rect 无法紧密适配，则会在视图中居中显示。

通常会在resizeEvent()的重写版本内部调用fitInView()，以确保当视图被调整大小时，整个场景或场景的某些部分会自动缩放以适应视口的新尺寸。 但请注意，如果在resizeEvent() 内部调用 fitInView()，且新的变换会切换滚动条的自动状态，则可能会导致不希望出现的重置递归。您可以通过将滚动条策略切换为“始终开启”或“始终关闭”来防止这种情况（参见horizontalScrollBarPolicy() 和verticalScrollBarPolicy()）。

如果 `rect ` 为空，或者视口过小，此函数将不执行任何操作。

另请参阅 setTransform()、ensureVisible() 和centerOn()。

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

确保item 能紧密嵌入视图中，并根据aspectRatioMode 对视图进行缩放。

另请参阅 ensureVisible() 和centerOn()。

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

此便捷函数等同于调用 fitInView(QRectF(x,y,w,h),aspectRatioMode)。

另请参阅 ensureVisible() 和centerOn()。

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

重写了：QWidget::focusInEvent(QFocusEvent *event)。

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

重新实现了：QWidget::focusNextPrevChild （bool next）。

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

重写了：QWidget::focusOutEvent(QFocusEvent *event)。

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

重写了：QWidget::inputMethodEvent(QInputMethodEvent *event)。

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

重写了：QWidget::inputMethodQuery （Qt::InputMethodQuery query）const。

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

在rect 中无效化layers 并安排重绘。rect 采用场景坐标系。在rect 中，layers 的任何缓存内容都将被无条件无效化并重绘。

您可以调用此函数，向QGraphicsView 通知场景背景或前景的变更。该函数通常用于具有瓦片式背景的场景，当QGraphicsView 已启用背景缓存时，用于通知背景变化。

请注意，QGraphicsView 目前仅支持背景缓存（参见QGraphicsView::CacheBackground ）。如果传入的图层中不包含QGraphicsScene::BackgroundLayer ，则此函数等同于调用update()。

另请参阅 QGraphicsScene::invalidate() 和update()。

bool QGraphicsView::isTransformed() const

如果视图已进行变换（即已分配了非恒等变换，或已调整滚动条），则返回true 。

另请参阅 setTransform()、horizontalScrollBar() 和verticalScrollBar()。

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

返回位于坐标pos （以视口坐标计）处的项目。如果该位置存在多个项目，则该函数返回最顶层的项目。

示例：

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

另请参阅 items() 和Sorting 。

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

提供此函数是为了方便使用。它等同于调用 itemAt(QPoint(x,y))。

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

返回关联场景中所有元素的列表，按堆叠顺序从高到低排列（即，返回列表中的第一个元素位于最顶层）。

另请参阅 QGraphicsScene::items() 和Sorting 。

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

返回视图中位于位置pos 处的所有项的列表。这些项按堆叠顺序从高到低排列（即，列表中的第一个项位于最上方，最后一个项位于最下方）。pos 采用视口坐标系。

该函数通常在QGraphicsView 的子类中，通过鼠标事件处理程序调用。pos 采用未变换的视口坐标系，与QMouseEvent::position()相同。

voidCustomView::mousePressEvent(QMouseEvent*event)
{
    qDebug() << "There are" << items(event->pos()).size()
            << "位置处的项目" <<mapToScene(event->pos());
}

另请参阅 QGraphicsScene::items() 和Sorting 。

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

提供此函数是为了方便使用。它相当于调用 items(QPoint(x,y))。

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

此便捷函数等同于调用 items(QRectF(x,y,w,h),mode)。

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

返回一个列表，其中包含所有根据mode 条件，要么被path 所包含，要么与 相交的项。path 采用视口坐标系。

mode 的默认值为Qt::IntersectsItemShape ；将返回所有形状与path 精确相交或被其包含的项目。

另请参阅 itemAt()、items()、mapToScene() 以及Sorting 。

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

返回一个列表，其中包含所有根据mode 的条件，要么被polygon 包含，要么与 相交的项。polygon 采用视口坐标系。

mode 的默认值为Qt::IntersectsItemShape ；所有形状与polygon 精确相交或被其包含的项目都会被返回。

这些项目按堆叠顺序从高到低排序（即，返回列表中的第一个项目是位于最上方的项目）。

另请参阅 itemAt()、items()、mapToScene() 和Sorting 。

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

返回一个列表，其中包含所有根据mode 的条件，要么被rect 包含，要么与 相交的项。rect 采用视口坐标系。

mode 的默认值为Qt::IntersectsItemShape ；所有形状与rect 精确相交或被其包含的项目都会被返回。

这些项目按堆叠顺序从高到低排序（即，返回列表中的第一个项目位于最顶层）。

另请参阅 itemAt()、items()、mapToScene() 以及Sorting 。

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

重写了：QAbstractScrollArea::keyPressEvent(QKeyEvent *e)。

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

重写：QWidget::keyReleaseEvent(QKeyEvent *event)。

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

将场景坐标系下的绘制路径path 转换为视口坐标系下的绘制路径。

另请参阅 mapToScene()。

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

将场景坐标point 转换为视口坐标。

另请参阅 mapToScene()。

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

将场景坐标系多边形polygon 转换为视口坐标系多边形。

另请参阅 mapToScene()。

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

将场景矩形rect 转换为视口坐标多边形。

另请参阅 mapToScene()。

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

提供此函数是为了方便使用。它相当于调用 mapFromScene(QPointF(x,y))。

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

提供此函数是为了方便使用。它等同于调用 mapFromScene(QRectF(x,y,w,h))。

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

返回映射到场景坐标绘制路径的视口绘制路径path 。

另请参阅 mapFromScene()。

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

返回映射到场景坐标的视口坐标point 。

注意：将point 处像素所覆盖的整个矩形映射到场景坐标系中，而非仅映射该点本身，有时会更实用。要实现这一点，可以调用 mapToScene(QRectpoint ,QSize(2, 2)))。

另请参阅 mapFromScene()。

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

返回映射到场景坐标多边形的视口多边形polygon 。

另请参阅 mapFromScene()。

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

返回映射到场景坐标多边形的视口矩形rect 。

另请参阅 mapFromScene()。

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

提供此函数是为了方便使用。它相当于调用 mapToScene(QPoint(x,y))。

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

提供此函数是为了方便使用。它相当于调用 mapToScene(QRect(x,y,w,h))。

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

重写了：QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)。

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

重写了：QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)。

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

重写了：QAbstractScrollArea::mousePressEvent(QMouseEvent *e)。

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

重写了：QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)。

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

重写了：QAbstractScrollArea::paintEvent(QPaintEvent *event)。

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

使用painter ，将场景中以视图坐标系表示的source 矩形转换为以绘图设备坐标系表示的target 。该函数可用于将视图内容捕获到绘图设备（如QImage ，例如用于截屏）上，或用于打印到QPrinter。例如：

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));

如果 `source ` 是空矩形，该函数将使用 `viewport() ->rect()` 来确定绘制内容。如果 `target ` 是空矩形，则将使用 `painter` 的绘图设备完整尺寸（例如，对于 QPrinter，即页面大小）。

源矩形的内容将根据aspectRatioMode 进行变换，以适应目标矩形。默认情况下，将保持纵横比，并将source 按比例缩放以适应target 。

另请参阅 QGraphicsScene::render()。

void QGraphicsView::resetCachedContent()

重置所有缓存内容。调用此函数将清除QGraphicsView 的缓存。如果当前缓存模式为CacheNone ，则此函数不执行任何操作。

当backgroundBrush 或QGraphicsScene::backgroundBrush 属性发生变化时，系统会自动调用此函数；仅当您重写了QGraphicsScene::drawBackground() 或QGraphicsView::drawBackground() 方法以绘制自定义背景，且需要触发完全重绘时，才需手动调用此函数。

另请参阅 cacheMode()。

void QGraphicsView::resetTransform()

将视图变换重置为单位矩阵。

另请参阅 transform() 和setTransform()。

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

重写了：QAbstractScrollArea::resizeEvent(QResizeEvent *event)。

void QGraphicsView::rotate(qreal angle)

将当前视图变换顺时针旋转angle 度。

另请参阅 setTransform()、transform()、scale()、shear() 以及translate()。

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

当橡皮筋矩形发生变化时，会触发此信号。视口矩形由 `rubberBandRect` 指定。拖动起始位置和拖动结束位置以场景坐标形式通过 `fromScenePoint ` 和 `toScenePoint` 提供。

当橡皮筋选择结束时，将触发此信号，并传入空值。

另请参阅 rubberBandRect()。

QRect QGraphicsView::rubberBandRect() const

如果用户当前正在使用“橡皮筋”进行项目选择，则该函数返回当前的“橡皮筋”选区（以视口坐标表示）。当用户未使用“橡皮筋”时，该函数返回（空）QRectF()。

请注意，该QRect 的一部分可能位于视觉视口之外。例如，它可能包含负值。

另请参阅 rubberBandSelectionMode 和rubberBandChanged()。

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

根据 (sx,sy) 对当前视图变换进行缩放。

另请参阅 setTransform()、transform()、rotate()、shear() 以及translate()。

QGraphicsScene *QGraphicsView::scene() const

返回当前在视图中可视化的场景的指针。如果当前没有场景被可视化，则返回nullptr 。

另请参阅 setScene()。

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

重新实现了：QAbstractScrollArea::scrollContentsBy(int dx, int dy)。

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

如果enabled 为 true，则启用flag ；否则禁用flag 。

另请参阅 optimizationFlags 。

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

如果enabled 为真，则启用渲染提示hint ；否则，该提示被禁用。

另请参阅 renderHints 。

void QGraphicsView::setScene(QGraphicsScene *scene)

将当前场景设置为scene 。如果当前正在显示scene ，则此函数不执行任何操作。

当在视图上设置场景时，QGraphicsScene::changed()信号会自动连接到该视图的updateScene()槽，并且视图的滚动条会根据场景的大小进行调整。

该视图不会获取 `scene` 的所有权。

另请参阅 scene()。

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

将视图的当前变换矩阵设置为matrix 。

如果combine 为true，则matrix 将与当前矩阵进行组合；否则，matrix 将替换当前矩阵。combine 默认值为false。

变换矩阵将场景转换为视图坐标系。使用由单位矩阵提供的默认变换时，视图中的一个像素代表场景中的一个单位（例如，一个 10x10 的矩形对象在视图中使用 10x10 像素绘制）。 如果应用 2x2 缩放矩阵，场景将按 1:2 的比例绘制（例如，一个 10x10 的矩形对象在视图中将使用 20x20 个像素进行绘制）。

示例：

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();

为了简化与经过变换的视图中对象的交互，QGraphicsView 提供了 mapTo... 和 mapFrom... 函数，用于在场景坐标与视图坐标之间进行转换。例如，您可以调用mapToScene() 将视图坐标映射到浮点型场景坐标，或调用mapFromScene() 将浮点型场景坐标映射到视图坐标。

另请参阅 transform()、resetTransform()、rotate()、scale()、shear() 以及translate()。

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

重写自：QAbstractScrollArea::setupViewport(QWidget *viewport)。

在调用setViewport()之后，QAbstractScrollArea 会调用此插槽。请在QGraphicsView 的子类中重写此函数，以便在使用新的视口widget 之前对其进行初始化。

另请参阅 setViewport()。

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

通过 (sh,sv) 对当前视图变换进行裁剪。

另请参阅 setTransform()、transform()、rotate()、scale() 以及translate()。

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

重写了：QWidget::showEvent(QShowEvent *event)。

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

重新实现了：QAbstractScrollArea::sizeHint() const。

QTransform QGraphicsView::transform() const

返回视图的当前变换矩阵。如果未设置当前变换，则返回单位矩阵。

另请参阅 setTransform()、rotate()、scale()、shear() 以及translate()。

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

将当前视图变换沿 (dx,dy) 方向平移。

另请参阅 setTransform()、transform()、rotate() 以及shear()。

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

安排更新场景矩形rects 。

另请参阅 QGraphicsScene::changed()。

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

通知QGraphicsView 该场景的场景矩形已发生变化。rect 是新的场景矩形。如果视图已显式设置了场景矩形，则此函数不执行任何操作。

另请参阅 sceneRect 和QGraphicsScene::sceneRectChanged()。

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

重写了：QAbstractScrollArea::viewportEvent(QEvent *event)。

QTransform QGraphicsView::viewportTransform() const

返回一个将场景坐标映射到视口坐标的矩阵。

另请参阅 mapToScene() 和mapFromScene()。

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

重写了：QAbstractScrollArea::wheelEvent(QWheelEvent *e)。