QGraphicsWidget Class

成员函数文档

QGraphicsWidget::QGraphicsWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())

构造一个 QGraphicsWidget 实例。可选的parent 参数传递给QGraphicsItem 的构造函数。可选的wFlags 参数指定窗口小部件的窗口标志（例如，窗口小部件是否应是窗口、工具、弹出窗口等）。

[virtual noexcept] QGraphicsWidget::~QGraphicsWidget()

销毁QGraphicsWidget 实例。

QList<QAction *> QGraphicsWidget::actions() const

返回此 widget 的操作列表（可能为空）。

另请参阅 insertAction()、removeAction()、QWidget::actions()、QAction::associatedWidgets() 和QAction::associatedGraphicsWidgets()。

void QGraphicsWidget::addAction(QAction *action)

将操作action 添加到该 widget 的操作列表中。

所有 QGraphicsWidget 都有一个QAction的列表，但它们可以用许多不同的方式以图形表示。QAction 列表（由actions() 返回）的默认用途是创建上下文QMenu 。

QGraphicsWidget 的每个操作只能有一个，添加已拥有的操作不会导致同一操作在 widget 中出现两次。

另请参阅 removeAction()、insertAction()、actions() 和QWidget::addAction()。

void QGraphicsWidget::addActions(const QList<QAction *> &actions)

将操作actions 添加到此 widget 的操作列表中。

另请参阅 removeAction(),QMenu,addAction() 和QWidget::addActions().

void QGraphicsWidget::adjustSize()

将窗口小部件的尺寸调整为其有效的首选尺寸提示。

该函数在项目首次显示时被隐式调用。

另请参阅 effectiveSizeHint() 和Qt::MinimumSize 。

[override virtual] QRectF QGraphicsWidget::boundingRect() const

重实现：QGraphicsItem::boundingRect() const.

[virtual protected] void QGraphicsWidget::changeEvent(QEvent *event)

该事件处理程序可以重新实现，以处理状态变化。

在此事件中发生变化的状态可通过event 进行检索。

更改事件包括QEvent::ActivationChange,QEvent::EnabledChange,QEvent::FontChange,QEvent::StyleChange,QEvent::PaletteChange,QEvent::ParentChange,QEvent::LayoutDirectionChange, 和QEvent::ContentsRectChange 。

[slot] bool QGraphicsWidget::close()

调用此函数关闭 widget。

如果 widget 已关闭，则返回true ；否则返回false 。此槽将首先向 widget 发送QCloseEvent ，widget 可能接受也可能不接受该事件。如果事件被忽略，则什么也不会发生。如果事件被接受，它将hide() 该 widget。

如果 widget 设置了Qt::WA_DeleteOnClose 属性，则会被删除。

[virtual protected] void QGraphicsWidget::closeEvent(QCloseEvent *event)

该事件处理程序用于event ，可在子类中重新实现，以接收部件关闭事件。默认实现接受事件。

另请参阅 close() 和QCloseEvent 。

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

重实现：QGraphicsObject::event(QEvent *ev)。

处理event 。QGraphicsWidget 处理以下事件：

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

重实现：QGraphicsItem::focusInEvent(QFocusEvent *event).

[virtual protected] bool QGraphicsWidget::focusNextPrevChild(bool next)

根据 Tab 键和 Shift+Tab 键的情况，查找一个新的窗口部件以给予键盘焦点，如果能找到新的窗口部件，则返回true ；否则返回false 。如果next 为真，则向前搜索；如果next 为假，则向后搜索。

有时，您需要重新实现该函数，以便为部件及其子部件提供特殊的焦点处理。例如，网络浏览器可能会重新实现该函数，以向前或向后移动当前活动链接，并仅在到达页面最后或第一个链接时调用基本实现。

子部件会调用父部件上的 focusNextPrevChild()，但只有包含子部件的窗口才会决定将焦点重定向到哪里。通过为对象重新实现该函数，您可以控制所有子窗口部件的焦点遍历。

另请参见 focusPolicy()。

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

重实现：QGraphicsItem::focusOutEvent(QFocusEvent *event).

QGraphicsWidget *QGraphicsWidget::focusWidget() const

如果此 widget、此 widget 的子 widget 或后代 widget 当前有输入焦点，此函数将返回指向该 widget 的指针。如果没有后代部件具有输入焦点，则返回nullptr 。

另请参阅 QGraphicsItem::focusItem() 和QWidget::focusWidget()。

[signal] void QGraphicsWidget::geometryChanged()

每当setGeometry() 中的几何体发生变化时，都会发出该信号。

[override virtual] void QGraphicsWidget::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

重实现：QGraphicsLayoutItem::getContentsMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const.

获取 widget 内容的边距。边距作为 qreals 的指针存储在left,top,right 和bottom 中。通过nullptr 可以省略每个参数。

另请参阅 setContentsMargins() 。

void QGraphicsWidget::getWindowFrameMargins(qreal *left, qreal *top, qreal *right, qreal *bottom) const

获取 widget 的窗口边距。边距以 qreals 的指针形式存储在left,top,right 和bottom 中。通过nullptr 可以省略每个参数。

另请参阅 setWindowFrameMargins() 和windowFrameRect()。

[virtual protected] void QGraphicsWidget::grabKeyboardEvent(QEvent *event)

该事件处理程序适用于event ，可在子类中重新实现，以接收QEvent::GrabKeyboard 事件的通知。

另请参阅 grabKeyboard() 和grabMouse()。

[virtual protected] void QGraphicsWidget::grabMouseEvent(QEvent *event)

该事件处理程序适用于event ，可在子类中重新实现，以接收QEvent::GrabMouse 事件的通知。

另请参阅 grabMouse() 和grabKeyboard()。

int QGraphicsWidget::grabShortcut(const QKeySequence &sequence, Qt::ShortcutContext context = Qt::WindowShortcut)

为 Qt 的快捷方式系统添加一个快捷方式，该快捷方式会在给定的context 中观察给定键sequence 。如果context 是Qt::ApplicationShortcut ，则快捷方式适用于整个应用程序。否则，快捷方式要么是该窗口部件的本地快捷方式（Qt::WidgetShortcut ），要么是窗口本身的快捷方式（Qt::WindowShortcut ）。对于不属于窗口的部件（即顶层部件及其子部件），Qt::WindowShortcut 快捷键适用于场景。

如果多个部件抓取了同一个按键sequence ，那么当按键sequence 出现时，将以非确定的顺序向所有适用该按键的部件发送QEvent::Shortcut 事件，但 "明确 "标志将设为 true。

另请参见 releaseShortcut()、setShortcutEnabled() 和QWidget::grabShortcut()。

[virtual protected] void QGraphicsWidget::hideEvent(QHideEvent *event)

该事件处理程序用于Hide 事件，在部件被隐藏后交付，例如，在部件之前显示时，调用了部件或其一个祖先的 setVisible(false)。

您可以重新实现该事件处理程序，以检测部件何时被隐藏。在event 上调用QEvent::accept() 或QEvent::ignore() 没有任何作用。

另请参阅 showEvent(),QWidget::hideEvent() 和ItemVisibleChange 。

[override virtual protected] void QGraphicsWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)

重实现：QGraphicsItem::hoverLeaveEvent(QGraphicsSceneHoverEvent *event).

[override virtual protected] void QGraphicsWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event)

重实现：QGraphicsItem::hoverMoveEvent(QGraphicsSceneHoverEvent *event).

[virtual protected] void QGraphicsWidget::initStyleOption(QStyleOption *option) const

根据此 widget 的当前状态为其填充样式选项对象，并将输出存储在option 中。默认实现用以下属性填充option 。

QGraphicsWidget 的子类应调用基本实现，然后使用qstyleoption_cast<>()测试option 的类型，或在存储特定于 widget 的选项之前测试QStyleOption::Type 。

例如

void MyGroupBoxWidget::initStyleOption(QStyleOption *option) const
{
    QGraphicsWidget::initStyleOption(option);
    if (QStyleOptionGroupBox *box = qstyleoption_cast<QStyleOptionGroupBox *>(option)) {
        // Add group box specific state.
        box->flat = isFlat();
        ...
    }
}

另请参见 QStyleOption::initFrom().

void QGraphicsWidget::insertAction(QAction *before, QAction *action)

将操作action 插入该 widget 的操作列表，位于操作before 之前。如果before 是nullptr 或before 不是该 widget 的有效操作，则会追加该操作。

QGraphicsWidget 的每个操作只能有一个。

另请参阅 removeAction(),addAction(),QMenu,actions() 和QWidget::insertActions() 。

void QGraphicsWidget::insertActions(QAction *before, const QList<QAction *> &actions)

将操作actions 插入此 widget 的操作列表，位于操作before 之前。如果before 是nullptr 或before 不是该 widget 的有效操作，则会追加该操作。

一个QGraphicsWidget 最多只能有一个动作。

另请参阅 removeAction()、QMenu 、insertAction() 和QWidget::insertActions()。

bool QGraphicsWidget::isActiveWindow() const

如果该窗口部件的窗口位于活动窗口中，或该窗口部件没有窗口但位于活动场景中（即当前有焦点的场景），则返回true 。

活动窗口是指包含当前具有输入焦点的子窗口部件或本身具有输入焦点的窗口。

另请参阅 QGraphicsScene::activeWindow()、QGraphicsScene::setActiveWindow() 和isActive()。

[override virtual protected] QVariant QGraphicsWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)

重实现：QGraphicsItem::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value).

QGraphicsWidget QGraphicsItem::GraphicsItemChange（QGraphicsItem::GraphicsItemChange 变化）使用此函数的基本实现来捕获和传递与项目中的状态变化相关的事件。因此，子类必须调用基本实现。

change value 是新值。

例如，QGraphicsWidget 使用 ItemVisibleChange 发送Show 和Hide 事件，使用 ItemPositionHasChanged 发送Move 事件，使用 ItemParentChange 发送ParentChange 事件并管理焦点链。

QGraphicsWidget 默认启用 ItemSendsGeometryChanges 标志，以跟踪位置变化。

另请参见 QGraphicsItem::itemChange().

QGraphicsLayout *QGraphicsWidget::layout() const

返回此 widget 的布局，如果当前没有布局管理此 widget，则返回nullptr 。

另请参阅 setLayout().

[virtual protected] void QGraphicsWidget::moveEvent(QGraphicsSceneMoveEvent *event)

对于GraphicsSceneMove 事件，该事件处理程序会在部件移动（例如，其本地位置发生变化）后发送。

只有在本地移动项目时，才会发生该事件。调用setTransform() 或移动项目的任何祖先都不会影响项目的本地位置。

您可以重新实施该事件处理程序，以检测部件是否发生了移动。在event 上调用QEvent::accept() 或QEvent::ignore() 不会产生任何影响。

另请参阅 ItemPositionChange 和ItemPositionHasChanged 。

[override virtual] void QGraphicsWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

重实现：QGraphicsItem::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)。

[virtual] void QGraphicsWidget::paintWindowFrame(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget = nullptr)

QGraphicsScene 调用此虚函数，以本地坐标为使用painter,option, 和widget 的窗口绘制窗口边框。基本实现使用当前样式来渲染框架和标题栏。

您可以在QGraphicsWidget 的子类中重新实现该函数，以提供窗口部件窗口边框的自定义渲染。

另请参阅 QGraphicsItem::paint() 。

[virtual protected] void QGraphicsWidget::polishEvent()

该事件是在项目构建完成后，但在通过场景显示或以其他方式访问项目之前，由场景传递给项目的。您可以使用该事件处理程序对部件进行最后的初始化，这需要项目完全构建完成。

基本实现什么也不做。

QRectF QGraphicsWidget::rect() const

以QRectF 的形式返回项目的局部矩形。该函数等同于QRectF(QPointF(),size()).

另请参阅 setGeometry() 和resize()。

void QGraphicsWidget::releaseShortcut(int id)

从 Qt 的快捷方式系统中删除带有给定id 的快捷方式。该 widget 将不再接收该快捷方式按键序列的QEvent::Shortcut 事件（除非它有其他按键序列相同的快捷方式）。

另请参阅 grabShortcut()、setShortcutEnabled() 和QWidget::releaseShortcut()。

void QGraphicsWidget::removeAction(QAction *action)

从该 widget 的操作列表中删除操作action 。

另请参阅 insertAction()、actions()、insertAction() 和QWidget::removeAction()。

void QGraphicsWidget::resize(qreal w, qreal h)

这是一个重载函数。

使用给定的width (w) 和height (h) 构造一个调整大小的程序。此便捷函数等同于调用 resize(QSizeF(w, h))。

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

[virtual protected] void QGraphicsWidget::resizeEvent(QGraphicsSceneResizeEvent *event)

对于GraphicsSceneResize 事件，该事件处理程序会在调整部件大小（即其本地大小发生变化）后发送。event 包含新旧大小。

只有在本地调整部件大小时才会发送该事件；在部件或其任何祖先或视图上调用setTransform() 不会影响部件的本地大小。

您可以重新实施该事件处理程序，以检测部件的大小是否已调整。在event 上调用QEvent::accept() 或QEvent::ignore() 不会产生任何影响。

另请参阅 geometry() 和setGeometry()。

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

重实现：QGraphicsItem::sceneEvent(QEvent *event).

QGraphicsWidgetSceneEvent() 的实现只是简单地将event 传递给QGraphicsWidget::event() 。您可以在event() 或任何便捷函数中处理您的 widget 的所有事件；您不应在QGraphicsWidget 的子类中重新实现此函数。

如果event 已被识别和处理，则返回true ；否则，返回false 。

另请参见 QGraphicsItem::sceneEvent()。

void QGraphicsWidget::setAttribute(Qt::WidgetAttribute attribute, bool on = true)

如果on 为 true，该函数将启用attribute ；否则attribute 将被禁用。

有关支持的属性及其用途的完整列表，请参阅QGraphicsWidget 的类文档。

另请参阅 testAttribute() 和QWidget::setAttribute()。

void QGraphicsWidget::setContentsMargins(QMarginsF margins)

将 widget 的内容边距设置为margins 。

内容边距用于指定布局，以定义子部件和布局的位置。边距对于将子部件限制在其自身几何形状的一部分的部件特别有用。例如，带有布局的组框会将子部件置于其框架内，但低于标题。

更改部件的内容边距总是会触发update() 并自动激活指定的布局。然后，该 widget 将收到ContentsRectChange 事件。

另请参阅 getContentsMargins() 和setGeometry()。

void QGraphicsWidget::setContentsMargins(qreal left, qreal top, qreal right, qreal bottom)

这是一个重载函数。

将 widget 的内容边距设置为left,top,right 和bottom 。

void QGraphicsWidget::setGeometry(qreal x, qreal y, qreal w, qreal h)

此方便函数等同于调用 setGeometry(QRectF(x,y,w,h)) 。

另请参阅 geometry() 和resize()。

void QGraphicsWidget::setLayout(QGraphicsLayout *layout)

将此 widget 的布局设置为layout 。在分配新布局之前，任何现有的布局管理器都会被删除。如果layout 是nullptr ，该 widget 将没有布局。现有子部件的几何图形将不受影响。

当前由layout 或其所有子布局管理的所有部件都会自动重新分配给该项。然后布局会失效，子部件的几何形状会根据此项目的geometry() 和 contentsMargins() 进行调整。在将布局分配给此 widget 后，未被layout 明确管理的子 widget 不受布局影响。

QGraphicsWidget 将获得 的所有权。layout

另请参阅 layout()、QGraphicsLinearLayout::addItem() 和QGraphicsLayout::invalidate()。

void QGraphicsWidget::setShortcutAutoRepeat(int id, bool enabled = true)

如果enabled 为 true，则启用自动重复给定id 的快捷方式；否则禁用。

另请参阅 grabShortcut()、releaseShortcut() 和QWidget::setShortcutAutoRepeat()。

void QGraphicsWidget::setShortcutEnabled(int id, bool enabled = true)

如果enabled 为 true，则启用给定id 的快捷方式；否则禁用该快捷方式。

另请参阅 grabShortcut()、releaseShortcut() 和QWidget::setShortcutEnabled()。

void QGraphicsWidget::setStyle(QStyle *style)

将 widget 的样式设置为style 。QGraphicsWidget 不会占用style 的所有权。

如果未指定样式，或者style 是nullptr ，widget 将使用QGraphicsScene::style() （如果已设置）。否则，widget 将使用QApplication::style()。

如果style 不是nullptr ，该函数将设置Qt::WA_SetStyle 属性；否则将清除该属性。

另请参阅 style()。

[static] void QGraphicsWidget::setTabOrder(QGraphicsWidget *first, QGraphicsWidget *second)

将second widget 移动到焦点 widget 的环上，这样当按下 Tab 键时，键盘焦点就会从first widget 移动到second widget。

请注意，由于second widget 的制表符顺序已更改，因此应按如下顺序排列链条：

setTabOrder(a, b); // a to b
setTabOrder(b, c); // a to b to c
setTabOrder(c, d); // a to b to c to d

而不是这样：

// WRONG
setTabOrder(c, d); // c to d
setTabOrder(a, b); // a to b AND c to d
setTabOrder(b, c); // a to b to c, but not c to d

如果first 是nullptr ，则表示如果场景获得 Tab 焦点（即用户按下 Tab 键，焦点进入场景），second 应是第一个接收输入焦点的部件。如果second 是nullptr ，则表示如果场景获得 BackTab 焦点，first 应是第一个获得焦点的部件。

默认情况下，选项卡顺序是使用部件创建顺序隐式定义的。

另请参阅 focusPolicy 和部件中的键盘焦点。

void QGraphicsWidget::setWindowFrameMargins(QMarginsF margins)

将 widget 的窗口边框边距设置为margins 。默认边框边距由样式提供，取决于当前的窗口标志。

如果您想绘制自己的窗口装饰，可以设置自己的边框边距来覆盖默认边距。

另请参阅 unsetWindowFrameMargins()、getWindowFrameMargins() 和windowFrameRect()。

void QGraphicsWidget::setWindowFrameMargins(qreal left, qreal top, qreal right, qreal bottom)

这是一个重载函数。

将窗口边框边距设置为left,top,right 和bottom 。

[override virtual] QPainterPath QGraphicsWidget::shape() const

重实现：QGraphicsItem::shape() const.

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

对于Show 事件，该事件处理程序会在 widget 显示之前发送，例如，当该 widget 或其某个祖先调用 setVisible(true) 时，该 widget 之前是隐藏的。

您可以重新实现该事件处理程序，以检测部件何时显示。在event 上调用QEvent::accept() 或QEvent::ignore() 没有任何作用。

另请参阅 hideEvent(),QWidget::showEvent() 和ItemVisibleChange 。

[override virtual protected] QSizeF QGraphicsWidget::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const

重实现：QGraphicsLayoutItem::sizeHint(Qt::SizeHint which, const QSizeF &constraint) const.

QStyle *QGraphicsWidget::style() const

返回指向 widget 样式的指针。如果该部件没有任何明确指定的样式，则返回场景的样式。反过来，如果场景没有任何指定的样式，该函数将返回QApplication::style()。

另请参阅 setStyle()。

bool QGraphicsWidget::testAttribute(Qt::WidgetAttribute attribute) const

如果此 widget 已启用attribute ，则返回true ；否则，返回false 。

另请参阅 setAttribute() 。

[override virtual] int QGraphicsWidget::type() const

重实现：QGraphicsItem::type() const.

[virtual protected] void QGraphicsWidget::ungrabKeyboardEvent(QEvent *event)

该事件处理程序适用于event ，可在子类中重新实现，以接收QEvent::UngrabKeyboard 事件的通知。

另请参阅 ungrabKeyboard() 和ungrabMouse()。

[virtual protected] void QGraphicsWidget::ungrabMouseEvent(QEvent *event)

该事件处理程序适用于event ，可在子类中重新实现，以接收QEvent::UngrabMouse 事件的通知。

另请参阅 ungrabMouse() 和ungrabKeyboard()。

void QGraphicsWidget::unsetWindowFrameMargins()

将窗口边框边距重置为样式提供的默认值。

另请参阅 setWindowFrameMargins()、getWindowFrameMargins() 和windowFrameRect()。

[override virtual protected] void QGraphicsWidget::updateGeometry()

重新实现：QGraphicsLayoutItem::updateGeometry().

如果该 widget 当前由布局管理，则该函数会通知布局该 widget 的尺寸提示已更改，布局可能需要相应地调整该 widget 的大小和位置。

如果 widget 的sizeHint() 已更改，请调用此函数。

另请参阅 QGraphicsLayout::invalidate()。

[virtual protected] bool QGraphicsWidget::windowFrameEvent(QEvent *event)

该事件处理程序适用于event ，如果该 widget 是一个窗口，则接收窗口边框的事件。它的基本实现支持默认的窗口边框交互，如移动、调整大小等。

您可以在QGraphicsWidget 的子类中重新实现该处理程序，以提供自己的自定义窗口边框交互支持。

如果event 已被识别和处理，则返回true ；否则，返回false 。

另请参阅 event() 。

QRectF QGraphicsWidget::windowFrameGeometry() const

以父坐标（包括任何窗口框架）返回 widget 的几何图形。

另请参阅 windowFrameRect()、getWindowFrameMargins() 和setWindowFrameMargins()。

QRectF QGraphicsWidget::windowFrameRect() const

返回 widget 的本地矩形，包括任何窗口边框。

另请参阅 windowFrameGeometry()、getWindowFrameMargins() 和setWindowFrameMargins()。

[virtual protected] Qt::WindowFrameSection QGraphicsWidget::windowFrameSectionAt(const QPointF &pos) const

返回pos 位置的窗口框架部分，如果该位置没有窗口框架部分，则返回Qt::NoSection 。

该函数在QGraphicsWidget 的基本实现中用于窗口框架交互。

如果您想自定义交互式移动或调整窗口大小的方式，可以重新实现此函数。例如，如果只允许通过右下角调整窗口大小，则可以重新实现此函数，为除Qt::BottomRightSection 以外的所有部分返回Qt::NoSection 。

另请参见 windowFrameEvent()、paintWindowFrame() 和windowFrameGeometry()。

Qt::WindowType QGraphicsWidget::windowType() const

返回窗口部件的窗口类型。

另请参阅 windowFlags()、isWindow() 和isPanel()。