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 处于场景坐标中。layers 在rect 内的任何缓存内容都将无条件失效并重新绘制。

您可以调用此函数来通知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;
   否则{        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::pos() 一样，是以未转换的视口坐标显示的。

voidCustomView::mousePressEvent(QMouseEvent*event){
    qDebug() << "There are" << items(event->pos()).size()
            << "items at position"<<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(QRect(point,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(...
...

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

如果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 为 true，则启用呈现提示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 为真，则matrix 与当前矩阵合并；否则，matrix 取代当前矩阵。默认情况下，combine 为假。

转换矩阵将场景转换为视图坐标。使用由标识矩阵提供的默认变换，视图中的一个像素代表场景中的一个单位（例如，在视图中使用 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).

QAbstractScrollArea 在调用setViewport() 后调用此槽。在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)。