QQuickItem 类

成员函数文档

[explicit] QQuickItem::QQuickItem(QQuickItem *parent = nullptr)

使用给定的 parent 构造一个 QQuickItem。

将 parent 用于既是 可视父元素 也是 QObject 父元素。

[override virtual noexcept] QQuickItem::~QQuickItem()

销毁 QQuickItem。

bool QQuickItem::acceptHoverEvents() const

返回此元素是否接受悬停事件。

默认值是 false。

如果这是 false，那么该元素将不会通过 hoverEnterEvent、hoverMoveEvent 和 hoverLeaveEvent 函数接收任何悬停事件。

另请参阅 setAcceptHoverEvents。

bool QQuickItem::acceptTouchEvents() const

返回此元素是否接受触摸事件。

默认值是 false。

如果这是 false，那么该元素将不会通过 touchEvent 函数接收任何触摸事件。

另请参阅 setAcceptTouchEvents。

Qt::MouseButtons QQuickItem::acceptedMouseButtons() const

返回此元素接受的鼠标按钮。

默认值是 Qt::NoButton；也就是说，不接受任何鼠标按钮。

如果某个元素不接受特定鼠标事件的鼠标按钮，则鼠标事件不会传递给该元素，而会传递给层次结构中的下一个元素。

另请参阅 setAcceptedMouseButtons() 和 acceptTouchEvents。

[virtual] QRectF QQuickItem::boundingRect() const

返回元素在其自己的坐标系中的范围：从 0, 0 到 width() 和 height 的矩形。

[invokable] QQuickItem *QQuickItem::childAt(qreal x, qreal y) const

返回在点 (x, y) 内此元素坐标系中的第一个可见子项。

如果没有此类项，则返回 nullptr。

QList<QQuickItem *> QQuickItem::childItems() const

返回此项目的子项。

[虚保护] bool QQuickItem::childMouseEventFilter(QQuickItem *item, QEvent *event)

重新实现此方法以过滤此项目子项接收到的指针事件。

仅当 filtersChildMouseEvents() 为 true 时，此方法才会被调用。

如果指定的 event 应该不传递给指定的子 item，则返回 true，否则返回 false。如果您返回 true，则还应该 接受 或 忽略 事件，以指示是否停止或继续事件传播。然而，事件始终会发送到所有父级链上的 childMouseEventFilters。

另请参阅setFiltersChildMouseEvents。

[重载虚保护] void QQuickItem::classBegin()

重新实现：QQmlParserStatus::classBegin。

派生类应在添加 中执行的自定义操作之前调用基类方法。

[虚] QRectF QQuickItem::clipRect() const

如果存在视口并且设置了 ItemObservesViewport 标志，则返回在 viewportItem() 中当前可见的矩形区域；否则，返回此项目在其自身坐标系中的范围：从 0, 0 到 width() 和 height() 的矩形。这是如果 clip 为 true 时预计要可见的区域。它也可以用于在 updatePaintNode() 中限制添加到场景图的图形。

例如，一个大型图纸或大型文本文档可能显示在一个仅占用应用程序窗口一部分的Flickable中：在这种情况下，Flickable是视口项，自定义内容渲染项可能会选择省略当前可见区域之外的场景图节点。如果设置了ItemObservesViewport标志，则该区域将在用户在Flickable中滚动内容时改变。

在嵌套视口项的情况下，clipRect()是所有设置了ItemIsViewport标志的祖先的boundingRect的交集，映射到this项的坐标系。

另请参阅boundingRect。

[覆盖虚拟受保护的] void QQuickItem::componentComplete()

重新实现：QQmlParserStatus::componentComplete。

派生类应在添加自己的componentComplete时调用基类方法。

[虚拟可调用] bool QQuickItem::contains(const QPointF &point) const

如果此类项包含局部坐标中的point，则返回true；否则返回false。

可以通过覆盖此函数来处理具有自定义形状的项的点碰撞。默认实现检查是否设置了containmentMask()，如果是，则检查点是否在置信区域内部；否则，检查点是否在边界框内部。

QCursor QQuickItem::cursor() const

返回此项的光标形状。

当鼠标光标悬停在该项上时，光标将采用此形状，除非设置了覆盖光标。有关一系列有用的形状，请参阅预定义光标对象列表。

如果没有设置光标形状，则返回一个具有Qt::ArrowCursor形状的光标；但是，如果有重叠项具有有效光标，则可能会显示其他光标形状。

另请参阅setCursor和unsetCursor。

[虚拟受保护的] void QQuickItem::dragEnterEvent(QDragEnterEvent *event)

可以在子类中重写此事件处理器，以接收该项的拖放进入事件。事件信息由event参数提供。

仅当为该项设置了ItemAcceptsDrops标志时，才提供拖放事件。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

另请参阅拖放和拖放和删除。

[虚拟受保护的] void QQuickItem::dragLeaveEvent(QDragLeaveEvent *event)

此事件处理程序可以被子类重新实现以接收项目的拖放离开事件。事件信息由 event 参数提供。

仅当为该项设置了ItemAcceptsDrops标志时，才提供拖放事件。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

另请参阅拖放和拖放和删除。

[虚保护] void QQuickItem::dragMoveEvent(QDragMoveEvent *event)

此事件处理程序可以被子类重新实现以接收项目的拖放移动事件。事件信息由 event 参数提供。

仅当为该项设置了ItemAcceptsDrops标志时，才提供拖放事件。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

另请参阅拖放和拖放和删除。

[虚保护] void QQuickItem::dropEvent(QDropEvent *event)

此事件处理程序可以被子类重新实现以接收项目的放下事件。事件信息由 event 参数提供。

仅当为该项设置了ItemAcceptsDrops标志时，才提供拖放事件。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

另请参阅拖放和拖放和删除。

[可调用，自 6.3 版起] void QQuickItem::dumpItemTree() const

递归地以该项目开始，弃掉有关项目视觉树的某些详细信息。

此函数是在Qt 6.3版本中引入的。

另请参阅：调试技术 和 GammaRay的Qt Quick检查器。

[可调用，自 6.3 版起] void QQuickItem::ensurePolished()

调用 updatePolish()

这有助于像布局（或定位器）这样的项目，它们在收到一个 PolishEvent 之前延迟计算其隐式宽度 (implicitWidth) 和隐式高度 (implicitHeight)。

通常，例如，向布局中添加或移除子项后，不会立即计算隐式大小（这是一种优化）。在某些情况下，你可能在添加子项后立即查询布局的隐式大小。如果是这种情况，在查询隐式大小之前使用此函数。

此函数是在Qt 6.3版本中引入的。

另请参阅：updatePolish() 和 polish。

[重写虚保护] bool QQuickItem::event(QEvent *ev)

重写： QObject::event(QEvent *e)。

bool QQuickItem::filtersChildMouseEvents() const

返回是否应将指向此项目子项的指针事件过滤通过此项目。

如果此项目和一个子项都具有 acceptTouchEvents() true，则在触摸交互发生时，此项目将过滤触摸事件。但是，如果项目或其子项无法处理触摸事件，则会调用 childMouseEventFilter 与合成的鼠标事件。

另请参阅 setFiltersChildMouseEvents() 和 childMouseEventFilter。

QQuickItem::Flags QQuickItem::flags() const

返回此项目的项目标志。

另请参阅 setFlags() 和 setFlag。

[虚，受保护] void QQuickItem::focusInEvent(QFocusEvent *event)

此事件处理程序可以在子类中重实现以接收项目的焦点进入事件。事件信息由 event 参数提供。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

如果您重实现了此函数，您应该调用基类的实现。

[虚，受保护] void QQuickItem::focusOutEvent(QFocusEvent *event)

此事件处理程序可以在子类中重实现以接收项目的焦点离开事件。事件信息由 event 参数提供。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[可调用] void QQuickItem::forceActiveFocus()

强制在项目上设置活动焦点。

此方法将焦点设置到项目，并确保对象层次结构中的所有祖先 FocusScope 对象也获得 聚焦。

焦点更改的原因将是 Qt::OtherFocusReason。使用重载方法指定焦点原因，以实现更好的焦点更改处理。

另请参阅 activeFocus。

[可调用] void QQuickItem::forceActiveFocus(Qt::FocusReason reason)

这是一个重载函数。

以给定 reason 的方式在项目上强制设置活动焦点。

此方法将焦点设置到项目，并确保对象层次结构中的所有祖先 FocusScope 对象也获得 聚焦。

另请参阅 activeFocus 和 Qt::FocusReason。

[虚，受保护，自 6.0 版本起] void QQuickItem::geometryChange(const QRectF &newGeometry, const QRectF &oldGeometry)

该函数被调用以处理该项目的几何从 oldGeometry 到 newGeometry 的变化。如果两个几何相同，则不执行任何操作。

派生类必须在其实现中调用基类方法。

此函数是在 Qt 6.0 版本中引入的。

QSharedPointer<QQuickItemGrabResult> QQuickItem::grabToImage(const QSize &targetSize = QSize())

将项目抓取到一个内存中的图像中。

抓取是异步发生的，当抓取完成后会发出 QQuickItemGrabResult::ready() 信号。

使用 targetSize 来指定目标图像的大小。默认情况下，结果将具有与项目相同的大小。

如果无法启动抓取，则函数返回 null。

另请参阅：QQuickWindow::grabWindow。

[受保护] bool QQuickItem::heightValid() const

返回是否显式设置了高度属性。

[虚受保护] void QQuickItem::hoverEnterEvent(QHoverEvent *event)

可以在此子类中重新实现此事件处理程序，以接收元素的悬停进入事件。事件信息由 event 参数提供。

如果 acceptHoverEvents 为 true，则会提供悬停事件。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[虚受保护] void QQuickItem::hoverLeaveEvent(QHoverEvent *event)

可以在子类中重新实现此事件处理程序，以接收元素的悬停离开事件。事件信息由 event 参数提供。

如果 acceptHoverEvents 为 true，则会提供悬停事件。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[虚受保护] void QQuickItem::hoverMoveEvent(QHoverEvent *event)

可以在子类中重新实现此事件处理程序，以接收元素的悬停移动事件。事件信息由 event 参数提供。

如果 acceptHoverEvents 为 true，则会提供悬停事件。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

qreal QQuickItem::implicitWidth() const

返回由确定内容的其他属性隐含的项宽度。

另请参阅：setImplicitWidth。

[虚受保护] void QQuickItem::inputMethodEvent(QInputMethodEvent *event)

可以在子类中重新实现此事件处理程序，以接收元素的输入方法事件。事件信息由 event 参数提供。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[虚] QVariant QQuickItem::inputMethodQuery(Qt::InputMethodQuery query) const

此方法仅适用于输入项。

如果此项是输入项，则应重新实现此方法以返回给定 query 的相关输入方法标志。

另请参阅：QWidget::inputMethodQuery。

bool QQuickItem::isAncestorOf(const QQuickItem *child) const

如果此元素是 child 的祖先（即，如果是 child 的父项，或 child 的父项的祖先之一），则返回 true。

另请参阅：parentItem。

[受保护] bool QQuickItem::isComponentComplete() const

如果 QML 组件的构建完成，则返回 true；否则返回 false。

通常情况下，我们需要将某些处理延迟到组件完成时进行。

另请参阅 componentComplete()。

bool QQuickItem::isFocusScope() const

如果这个项目是焦点范围，返回true，否则返回false。

[virtual] bool QQuickItem::isTextureProvider() const

如果此项目是纹理提供者，返回true。默认实现返回false。

此函数可以从任何线程调用。

[virtual protected] void QQuickItem::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &value)

当此项目的change发生时调用。

value包含有关变化的额外信息（如有适用）。

如果您在子类中重新实现此方法，请确保在实现结束时调用

QQuickItem::itemChange(change, value);

以确保windowChanged()信号将被发射。

bool QQuickItem::keepMouseGrab() const

如果鼠标输入应该独家与这个项目保持联系，则返回true。

另请参阅 setKeepMouseGrab()。

bool QQuickItem::keepTouchGrab() const

如果此项目捕获的触摸点应该独家与这个项目保持联系，则返回true。

另请参阅 setKeepTouchGrab()和keepMouseGrab。

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

可以在子类中重新实现此事件处理器来接收项目的按键事件。由event参数提供事件信息。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

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

可以在子类中重新实现此事件处理器来接收项目的按键释放事件。由event参数提供事件信息。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[invokable] QPointF QQuickItem::mapFromGlobal(const QPointF &point) const

在全局屏幕坐标系中将给定的point映射到该项目坐标系中的等效点，并返回映射坐标。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

例如，这可能有助于向Qt Quick组件添加弹出窗口。

参见：概念 - Qt Quick中的视觉坐标。

[可调用] QPointF QQuickItem::mapFromItem(const QQuickItem *item, const QPointF &point) const

将给定的点在项的坐标系中映射到该项坐标系内的等效点，并返回映射后的坐标。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

如果项是nullptr，则将点从场景坐标系映射过来。

参见：概念 - Qt Quick中的视觉坐标。

QPointF QQuickItem::mapFromScene(const QPointF &point) const

将给定的点在场景的坐标系中映射到该项坐标系内的等效点，并返回映射后的坐标。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

参见：概念 - Qt Quick中的视觉坐标。

QRectF QQuickItem::mapRectFromItem(const QQuickItem *item, const QRectF &rect) const

将给定的矩形在项的坐标系中映射到该项坐标系内的等效矩形区域，并返回映射后的矩形值。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

如果项是nullptr，则将矩形从场景坐标系映射过来。

参见：概念 - Qt Quick中的视觉坐标。

QRectF QQuickItem::mapRectFromScene(const QRectF &rect) const

将给定的矩形在场景的坐标系中映射到该项坐标系内的等效矩形区域，并返回映射后的矩形值。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

参见：概念 - Qt Quick中的视觉坐标。

QRectF QQuickItem::mapRectToItem(const QQuickItem *item, const QRectF &rect) const

将给定的矩形在本次项的坐标系中映射到项坐标系内的等效矩形区域，并返回映射后的矩形值。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

如果项是nullptr，则将矩形映射到场景坐标系。

参见：概念 - Qt Quick中的视觉坐标。

QRectF QQuickItem::mapRectToScene(const QRectF &rect) const

将给定的矩形在本次项的坐标系中映射到场景坐标系内的等效矩形区域，并返回映射后的矩形值。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

参见：概念 - Qt Quick中的视觉坐标。

[可调用] QPointF QQuickItem::mapToGlobal(const QPointF &point) const

将给定的小点在此项的坐标系中映射到全局屏幕坐标系中的等效点，并返回映射的坐标。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

例如，这可能有助于向Qt Quick组件添加弹出窗口。

参见：概念 - Qt Quick中的视觉坐标。

[可调用] QPointF QQuickItem::mapToItem(const QQuickItem *item, const QPointF &point) const

将给定的小点在此项的坐标系中映射到项的坐标系中的等效点，并返回映射的坐标。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

如果 项 是 nullptr，则此映射将 点 映射到场景的坐标系。

参见：概念 - Qt Quick中的视觉坐标。

QPointF QQuickItem::mapToScene(const QPointF &point) const

将给定的小点在此项的坐标系中映射到场景坐标系的等效点，并返回映射的坐标。

在映射中使用项目以下属性：x、y、scale、rotation、transformOrigin和transform。

参见：概念 - Qt Quick中的视觉坐标。

[虚受保护] void QQuickItem::mouseDoubleClickEvent(QMouseEvent *event)

此事件处理器可以在子类中重新实现以接收项的鼠标双击事件。事件信息由 事件 参数提供。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[虚受保护] void QQuickItem::mouseMoveEvent(QMouseEvent *event)

此事件处理器可以在子类中重新实现以接收项的鼠标移动事件。事件信息由 事件 参数提供。

为了接收鼠标移动事件，前面的鼠标按下事件必须被接受（通过重写 mousePressEvent 等），并且 acceptedMouseButtons() 必须返回相关的鼠标按钮。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[虚受保护] void QQuickItem::mousePressEvent(QMouseEvent *event)

此事件处理器可以在子类中重新实现以接收项的鼠标按下事件。事件信息由 事件 参数提供。

为了接收鼠标按下事件，acceptedMouseButtons() 必须返回相关的鼠标按钮。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[虚受保护] void QQuickItem::mouseReleaseEvent(QMouseEvent *event)

此事件处理器可以在子类中重新实现以接收项的鼠标释放事件。事件信息由 事件 参数提供。

为了接收鼠标释放事件，前面的鼠标按下事件必须被接受（通过重写 mousePressEvent 等）并且 acceptedMouseButtons() 必须返回相关的鼠标按钮。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[虚受保护] void QQuickItem::mouseUngrabEvent()

此事件处理器可以在子类中重新实现以在发生鼠标未捕获事件时通知该项。

[可调用] QQuickItem *QQuickItem::nextItemInFocusChain(bool forward = true)

返回此项目焦点链中下一个项目。如果 forward 为 true 或未提供，则表示正向方向的下个项目。如果 forward 为 false，则表示反向方向的下个项目。

void QQuickItem::polish()

为此项目安排一个polish事件。

当场景图处理请求时，它将调用此项目上的 updatePolish()。

另请参阅updatePolish()、QQuickTest::qIsPolishScheduled() 和 ensurePolished()。

[虚拟受保护的] void QQuickItem::releaseResources()

当项目应该释放由 QQuickItem::updatePaintNode() 返回的节点管理之外的所有图形资源时，将调用此函数。

这发生在项目即将从之前渲染的窗口中移除时。当函数被调用时，项目保证有一个 窗口。

此函数在GUI线程上调用，当它被使用时，渲染线程的状态是未知的。对象不应直接删除，而应使用 QQuickWindow::scheduleRenderJob() 协调清理。

另请参阅图形资源处理。

QQuickItem *QQuickItem::scopedFocusItem() const

如果此项目是焦点作用域，则返回当前具有焦点的其焦点链中的项目。

如果此项目不是焦点作用域，则返回 nullptr。

void QQuickItem::setAcceptHoverEvents(bool enabled)

如果 enabled 为 true，则将此项目设置为接受悬停事件；否则，此项目不接受悬停事件。

另请参阅acceptHoverEvents。

void QQuickItem::setAcceptTouchEvents(bool enabled)

如果 enabled 为 true，则将此项目设置为接受触摸事件；否则，此项目不接受触摸事件。

另请参阅acceptTouchEvents。

void QQuickItem::setAcceptedMouseButtons(Qt::MouseButtons buttons)

将此项目接受的鼠标按钮设置为 buttons。

另请参阅acceptedMouseButtons。

void QQuickItem::setCursor(const QCursor &cursor)

设置此项目的光标形状。

另请参阅cursor() 和 unsetCursor()。

void QQuickItem::setFiltersChildMouseEvents(bool filter)

设置是否应通过此项目过滤针对此项目子项的指针事件。

如果 filter 为 true，当触发表项子项的指针事件时，将调用 childMouseEventFilter。

另请参阅filtersChildMouseEvents。

void QQuickItem::setFlag(QQuickItem::Flag flag, bool enabled = true)

如果 enabled 为 true，则启用此项目指定的 flag；如果 enabled 为 false，则禁用标志。

这为项目提供各种提示；例如，ItemClipsChildrenToShape 标志指示此项目的所有子项目应裁剪以适合项目区域。

void QQuickItem::setFlags(QQuickItem::Flags flags)

启用此项目指定的 flags。

另请参阅flags() 和 setFlag。

void QQuickItem::setFocusPolicy(Qt::FocusPolicy policy)

将此项目的焦点策略设置为 policy。

另请参阅focusPolicy。

void QQuickItem::setKeepMouseGrab(bool keep)

设置鼠标输入是否应优先属于此项目。

对于希望抓取并保留预定义手势后鼠标交互的项目，这很有用。例如，一个对于水平鼠标移动感兴趣的项目可能在超过某个阈值后将 keepMouseGrab 设置为 true。一旦 keepMouseGrab 被设置为 true，过滤项目将不会响应用户的事件。

如果 keep 为 false，过滤项目可能会偷走抓取。例如，Flickable 可能会尝试偷走鼠标抓取，如果它检测到用户已经开始移动视口。

另请参阅keepMouseGrab。

void QQuickItem::setKeepTouchGrab(bool keep)

设置此项目抓取的触摸点是否应优先属于此项目。

对于希望在预定义手势后抓取并保留特定触摸点的项目，这很有用。例如，对水平触摸点移动感兴趣的项目可能在超过某个阈值后将 setKeepTouchGrab 设置为 true。一旦 setKeepTouchGrab 被设置为 true，过滤项目将不会响应用户的相关触摸点。

如果 保持 为假，过滤项目可能窃取鼠标抓取。例如，Flickable 如果检测到用户开始移动视口，可能会尝试窃取触摸点抓取。

另请参阅 keepTouchGrab() 和 setKeepMouseGrab。

void QQuickItem::setSize(const QSizeF &size)

将项目的大小设置为 size。 此方法保留对宽度和高度的所有现有绑定；因此，任何触发绑定再次执行的改变将覆盖设置的值。

另请参阅 size、setWidth 和 setHeight。

QSizeF QQuickItem::size() const

返回项目的大小。

另请参阅 setSize、width 和 height。

void QQuickItem::stackAfter(const QQuickItem *sibling)

将指定的 sibling 项在子项列表中的索引移动到此项之后。子项的顺序影响视觉堆叠顺序和标签焦点导航顺序。

假设两项的z值相同，这将导致 sibling 在此项之下渲染。

如果两项都将 activeFocusOnTab 设置为 true，这也会导致标签焦点顺序发生变化，sibling 将在此项之前获得焦点。

给定的 sibling 必须与此项是兄弟关系；也就是说，它们必须具有相同的直接 parent。

另请参阅 概念 - Qt Quick中的视觉父级。

void QQuickItem::stackBefore(const QQuickItem *sibling)

将指定的 sibling 项在子项列表中的索引移动到此项之前。子项的顺序影响视觉堆叠顺序和标签焦点导航顺序。

假设两项的z值相同，这将导致 sibling 在此项之上渲染。

如果两项都将 activeFocusOnTab 设置为 true，这也会导致标签焦点顺序发生变化，sibling 将在此项之后获得焦点。

给定的 sibling 必须与此项是兄弟关系；也就是说，它们必须具有相同的直接 parent。

另请参阅 概念 - Qt Quick中的视觉父级。

[虚拟] QSGTextureProvider *QQuickItem::textureProvider() const

返回项目的水印提供者。默认实现返回 nullptr。

此函数只能在渲染线程上调用。

[虚拟受保护] void QQuickItem::touchEvent(QTouchEvent *event)

可以在子类中重写此事件处理程序以接收项目的触摸事件。事件信息由参数 event 提供。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[虚拟受保护] void QQuickItem::touchUngrabEvent()

可以在子类中重写此事件处理程序以通知当此项发生触摸释放事件时。

void QQuickItem::unsetCursor()

清除此项目的光标形状。

另请参阅 cursor() 和 setCursor().

[slot] void QQuickItem::update()

为此项目调度调用 updatePaintNode().

如果项目在 QQuickWindow 中可见，则总会调用 QQuickItem::updatePaintNode()。

只有指定了 QQuickItem::ItemHasContents 的项目才能调用 QQuickItem::update().

[protected] void QQuickItem::updateInputMethod(Qt::InputMethodQueries queries = Qt::ImQueryInput)

如有必要，通知输入法已更新查询值。queries 表示已更改的属性。

[virtual protected] QSGNode *QQuickItem::updatePaintNode(QSGNode *oldNode, QQuickItem::UpdatePaintNodeData *updatePaintNodeData)

在需要将项目状态与场景图同步时在渲染线程上调用。

如果用户已将 QQuickItem::ItemHasContents 标志设置在项目上，则调用 QQuickItem::update() 后会调用此函数。

该函数应该返回此项目场景图子树的根。大多数实现将返回一个包含此项目可视表示的单一 QSGGeometryNode。 oldNode 是上一次调用该函数时返回的节点。 updatePaintNodeData 提供指向与此 QQuickItem 关联的 QSGTransformNode 的指针。

QSGNode *MyItem::updatePaintNode(QSGNode *node, UpdatePaintNodeData *)
{
    QSGSimpleRectNode *n = static_cast<QSGSimpleRectNode *>(node);
    if (!n) {
        n = new QSGSimpleRectNode();
        n->setColor(Qt::red);
    }
    n->setRect(boundingRect());
    return n;
}

在执行此函数时主线程将被阻塞，因此可以安全地从主线程中的 QQuickItem 实例和其他对象中读取值。

如果没有调用 QQuickItem::updatePaintNode() 导致实际场景图更改，如 QSGNode::markDirty() 或添加和删除节点，则底层的实现可能会决定不再次渲染场景，因为视觉效果相同。

另请参阅 QSGMaterial、QSGGeometryNode、QSGGeometry、QSGFlatColorMaterial、QSGTextureMaterial、QSGNode::markDirty() 和 图形资源处理.

[virtual protected] void QQuickItem::updatePolish()

此函数应执行所需为此项目执行的全部布局。

当调用polish() 函数时，场景图将为该项目安排一个抛光事件。当场景图准备渲染此项目时，它会调用updatePolish()方法来执行渲染下一帧之前所需的任何项目布局。

另请参阅ensurePolished().

QQuickItem *QQuickItem::viewportItem() const

如果设置了ItemObservesViewport 标志，则返回带有ItemIsViewport 标志的最近父项。如果没有设置此标志或找不到其他视口项目，则返回窗口的内容项。

仅在没有任何视口项且该项目不在窗口中显示时，返回 nullptr。

另请参阅clipRect。

[虚拟受保护] void QQuickItem::wheelEvent(QWheelEvent *event)

此事件处理器可以由子类重新实现以接收项目轮事件。事件信息通过event参数提供。

默认情况下接受事件，因此如果您重写此函数，则不需要显式接受事件。如果您不接受事件，请调用event->ignore()。

[受保护] bool QQuickItem::widthValid() const

返回是否明确设置了宽度属性。

QQuickWindow *QQuickItem::window() const

返回绘制此项的窗口。

直到项目被分配到场景中，该项才具有窗口。当项目进入或从场景移除时，windowChanged() 信号提供通知。

[信号] void QQuickItem::windowChanged(QQuickWindow *window)

当项目的窗口发生变化时，发出此信号。