QQuickItem Class

成员函数文档

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

用给定的parent 构建一个 QQuickItem。

parent 将同时用作visual 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

Returns the first visible child item found at point (x,y) within the coordinate system of this item.

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

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

返回此项目的子项。

[virtual protected] bool QQuickItem::childMouseEventFilter(QQuickItem *item, QEvent *event)

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

只有当filtersChildMouseEvents() 是true 时，才会调用此方法。

如果指定的event 不应传递给指定的子项item ，则返回true ，否则返回false 。如果返回true ，则还应返回accept 或ignore event ，以提示事件传播是应该停止还是继续。不过，event 将始终发送给父链条上的所有子鼠标事件过滤器。

另请参阅 setFiltersChildMouseEvents() 。

[override virtual protected] void QQuickItem::classBegin()

重新实现：QQmlParserStatus::classBegin().

派生类应先调用基类方法，然后再在 classBegin 处添加自己要执行的操作。

[virtual] QRectF QQuickItem::clipRect() const

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

例如，一幅大型图画或一个大型文本文档可能会在 Flickable 中显示，而 Flickable 只占据应用程序窗口的一部分：在这种情况下，Flickable 就是视口项，自定义内容渲染项可以选择省略当前可见区域以外的场景图节点。如果设置了ItemObservesViewport 标志，用户每次滚动 Flickable 中的内容时，该区域都会发生变化。

对于嵌套视口项目，clipRect() 是所有设置了ItemIsViewport 标志的祖先的boundingRects 的交集，并映射到此项目的坐标系。

另请参阅 boundingRect().

[override virtual protected] void QQuickItem::componentComplete()

重新实现：QQmlParserStatus::componentComplete().

派生类应先调用基类方法，然后再添加自己的操作，以便在 componentComplete 时执行。

[virtual invokable] bool QQuickItem::contains(const QPointF &point) const

如果此项目包含point ，则返回true ，否则返回false 。

此函数可以重载，以便在具有自定义形状的项目中处理点碰撞。如果设置了containmentMask() ，默认实现会检查点是否在 () 内，否则会检查点是否在边界框内。

QCursor QQuickItem::cursor() const

返回此项目的光标形状。

除非设置了覆盖光标，否则鼠标指针在该项目上移动时将呈现这种形状。有关一系列有用的形状，请参阅list of predefined cursor objects 。

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

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

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

该事件处理程序可在子类中重新实现，以接收项目的拖入事件。事件信息由event 参数提供。

只有为该项目设置了ItemAcceptsDrops 标志，才会提供拖放事件。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

另请参阅 Drag 和拖放。

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

该事件处理程序可在子类中重新实现，以接收项目的拖离事件。事件信息由event 参数提供。

只有为该项目设置了ItemAcceptsDrops 标志，才会提供拖放事件。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

另请参阅 Drag 和拖放。

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

该事件处理程序可在子类中重新实现，以接收项目的拖动事件。事件信息由event 参数提供。

只有为该项目设置了ItemAcceptsDrops 标志，才会提供拖放事件。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

另请参阅 Drag 和拖放。

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

该事件处理程序可在子类中重新实现，以接收项目的下拉事件。事件信息由event 参数提供。

只有为该项目设置了ItemAcceptsDrops 标志，才会提供拖放事件。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

另请参阅 Drag 和拖放。

[invokable, since 6.3] void QQuickItem::dumpItemTree() const

以递归方式转储从该项目开始的项目可视化树的一些细节。

此函数在 Qt 6.3 中引入。

另请参阅 调试技巧和GammaRay 的Qt Quick Inspector。

[invokable, since 6.3] void QQuickItem::ensurePolished()

调用updatePolish()

这对布局（或定位器）等项目非常有用，它们可以延迟计算implicitWidth 和implicitHeight ，直到收到 PolishEvent（波兰语事件）。

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

此函数在 Qt 6.3 中引入。

另请参阅 updatePolish() 和polish()。

[override virtual protected] 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()。

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

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

默认情况下会接受该事件，因此在重新实现该函数时无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

如果重新实现此函数，则应调用基类实现。

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

该事件处理程序可在子类中重新实现，以接收项目的焦点移出事件。事件信息由event 参数提供。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

[invokable] void QQuickItem::forceActiveFocus()

强制将焦点放在项目上。

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

焦点改变的原因将是Qt::OtherFocusReason 。请使用重载方法指定焦点原因，以便更好地处理焦点变化。

另请参阅 activeFocus 。

[invokable] void QQuickItem::forceActiveFocus(Qt::FocusReason reason)

这是一个重载函数。

通过给定的reason ，强制将焦点集中在项目上。

该方法将焦点设置在项目上，并确保对象层次结构中的所有祖先FocusScope 对象也被赋予focus 。

另请参阅 activeFocus 和Qt::FocusReason 。

[virtual protected, since 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 可指定目标图像的大小。默认情况下，抓取结果的大小与 item 相同。

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

另请参阅 QQuickWindow::grabWindow() 。

[protected] bool QQuickItem::heightValid() const

返回高度属性是否已明确设置。

[virtual protected] void QQuickItem::hoverEnterEvent(QHoverEvent *event)

该事件处理程序可在子类中重新实现，以接收项目的悬停-输入事件。事件信息由event 参数提供。

只有当acceptHoverEvents() 为 true 时，才会提供悬停事件。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

[virtual protected] void QQuickItem::hoverLeaveEvent(QHoverEvent *event)

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

只有当acceptHoverEvents() 为 true 时，才会提供悬停事件。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

[virtual protected] void QQuickItem::hoverMoveEvent(QHoverEvent *event)

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

只有当acceptHoverEvents() 为 true 时，才会提供悬停事件。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

qreal QQuickItem::implicitWidth() const

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

另请参阅 setImplicitWidth().

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

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

默认情况下会接受该事件，因此如果重新实现该函数，无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

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

本方法仅适用于输入项。

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

另请参阅 QWidget::inputMethodQuery() 。

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

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

另请参阅 parentItem().

[protected] 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

返回鼠标输入是否应完全保留在此项目中。

另请参阅 setKeepMouseGrab()、QEvent::accept() 和QEvent::ignore()。

bool QQuickItem::keepTouchGrab() const

返回此项目所抓取的触摸点是否只保留在此项目中。

另请参阅 setKeepTouchGrab()、keepMouseGrab()、QEvent::accept() 和QEvent::ignore()。

[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 中的概念 - 视觉坐标 。

[invokable] QPointF QQuickItem::mapFromItem(const QQuickItem *item, const QPointF &point) const

将item 坐标系中的给定point 映射到此项目坐标系中的对应点，并返回映射后的坐标。

映射时会用到项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

如果item 是nullptr ，则会从场景坐标系映射point 。

另请参阅 Qt Quick 中的概念 - 视觉坐标。

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

将场景坐标系中给定的point 映射到此项目坐标系中的对应点，并返回映射后的坐标。

映射时会用到项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

另请参阅 Qt Quick 中的概念 - 视觉坐标。

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

将item 坐标系中的给定rect 映射到此项目坐标系中的等效矩形区域，并返回映射后的矩形值。

映射过程中会使用项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

如果item 是nullptr ，则会从场景坐标系映射rect 。

另请参阅 Qt Quick 中的概念 - 视觉坐标。

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

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

映射过程中会使用项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

另请参阅 Qt Quick 中的概念 - 视觉坐标。

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

将此项目坐标系中给定的rect 映射到item 坐标系中的等效矩形区域，并返回映射后的矩形值。

映射过程中会使用项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

如果item 是nullptr ，则会将rect 映射到场景的坐标系。

另请参阅 Qt Quick 中的概念 - 视觉坐标。

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

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

映射过程中会使用项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

另请参阅 Qt Quick 中的概念 - 视觉坐标。

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

将此项目坐标系中给定的point 映射到全局屏幕坐标系中的对应点，并返回映射后的坐标。

映射时会用到项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

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

另请参阅 Qt Quick 中的概念 - 可视坐标。

[invokable] QPointF QQuickItem::mapToItem(const QQuickItem *item, const QPointF &point) const

将此项目坐标系中给定的point 映射到item 坐标系中的对应点，并返回映射后的坐标。

映射时会用到项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

如果item 是nullptr ，则会将point 映射到场景的坐标系。

另请参阅 Qt Quick 中的概念 - 视觉坐标。

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

将此项目坐标系中给定的point 映射到场景坐标系中的对应点，并返回映射后的坐标。

映射时会用到项目的以下属性：x,y,scale,rotation,transformOrigin, 和transform 。

如果项目是不同场景的一部分，则映射包括两个场景的相对位置。

另请参阅 Qt Quick 中的概念 - 视觉坐标。

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

该事件处理程序可在子类中重新实现，以接收项目的鼠标双击事件。事件信息由event 参数提供。

默认情况下接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

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

该事件处理程序可在子类中重新实现，以接收项目的鼠标移动事件。事件信息由event 参数提供。

要接收鼠标移动事件，必须接受前面的鼠标按下事件（例如通过覆盖mousePressEvent() ），并且acceptedMouseButtons() 必须返回相关的鼠标按钮。

默认情况下会接受该事件，因此如果重新实现该函数，不必明确接受该事件。如果不接受事件，请调用event->ignore() 。

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

该事件处理程序可在子类中重新实现，以接收某个项目的鼠标按下事件。事件信息由event 参数提供。

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

默认情况下会接受该事件，因此如果重新实现该函数，不必明确接受该事件。如果不接受事件，请调用event->ignore() 。

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

该事件处理程序可在子类中重新实现，以接收项目的鼠标释放事件。事件信息由event 参数提供。

要接收鼠标释放事件，必须接受前面的鼠标按下事件（例如通过覆盖mousePressEvent() ），并且acceptedMouseButtons() 必须返回相关的鼠标按钮。

默认情况下会接受该事件，因此如果重新实现该函数，不必明确接受该事件。如果不接受事件，请调用event->ignore() 。

[virtual protected] void QQuickItem::mouseUngrabEvent()

可以在子类中重新实现该事件处理程序，以便在该项目发生鼠标松开事件时收到通知。

[invokable] QQuickItem *QQuickItem::nextItemInFocusChain(bool forward = true)

返回焦点链中紧邻此项目的项目。如果forward 是true ，或未提供，则是向前方向的下一个项目。如果forward 是false ，则是后向的下一个项目。

void QQuickItem::polish()

为该项目安排抛光事件。

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

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

[virtual protected] void QQuickItem::releaseResources()

当项目需要释放尚未由QQuickItem::updatePaintNode() 返回的节点管理的图形资源时，将调用此函数。

这种情况发生在项目即将从其之前渲染的窗口中移除时。调用该函数时，保证项目有一个window 。

该函数在图形用户界面线程上调用，使用时渲染线程的状态未知。不应直接删除对象，而应使用QQuickWindow::scheduleRenderJob() 进行计划清理。

另请参见 Graphics Resource Handling 。

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 形状。

另请参阅 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 为假，过滤项目可能会窃取抓取内容。例如，如果Flickable 检测到用户开始移动视口，它就会尝试窃取鼠标抓取。

另请参阅 keepMouseGrab().

void QQuickItem::setKeepTouchGrab(bool keep)

设置此项目抓取的触摸点是否只能保留在此项目中。

这对于希望按照预定义手势抓取并保留特定触摸点的项目非常有用。例如，对水平触摸点移动感兴趣的项目可以在超过阈值后将 setKeepTouchGrab 设为 true。一旦 setKeepTouchGrab 设置为 true，过滤项目将不会对相关触摸点做出反应。

如果keep 为假，过滤项目可能会窃取抓取。例如，如果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 中的 Concepts - Visual Parent。

void QQuickItem::stackBefore(const QQuickItem *sibling)

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

假设两个项目的 Z 值相同，这将使sibling 呈现在此项目之上。

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

给定的sibling 必须是此项目的同级项目；也就是说，它们必须有相同的直接parent 。

另请参阅 Qt Quick 中的 Concepts - Visual Parent。

[virtual] QSGTextureProvider *QQuickItem::textureProvider() const

返回项目的纹理提供程序。默认实现返回nullptr 。

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

[virtual protected] void QQuickItem::touchEvent(QTouchEvent *event)

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

默认情况下接受事件，因此如果重新实现此函数，则无需明确接受事件。如果不接受事件，请调用event->ignore() 。

[virtual protected] 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() 和Graphics Resource Handling 。

[virtual protected] void QQuickItem::updatePolish()

该函数应根据需要为该项目执行任何布局。

调用polish() 时，场景图会为该项目安排一次抛光事件。当场景图准备好渲染此项目时，它会调用 updatePolish() 在渲染下一帧之前按要求进行项目布局。

另请参阅 ensurePolished()。

QQuickItem *QQuickItem::viewportItem() const

如果设置了ItemObservesViewport 标志，则返回与ItemIsViewport 标志最接近的父对象。如果未设置标记，或未找到其他视口项目，则返回窗口的 contentItem。

只有在没有视口项目且该项目未在窗口中显示的情况下，才会返回nullptr 。

另请参见 clipRect().

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

该事件处理程序可在子类中重新实现，以接收项目的轮子事件。事件信息由event 参数提供。

默认情况下会接受该事件，因此如果重新实现该函数，则无需明确接受该事件。如果不接受事件，请调用event->ignore() 。

[protected] bool QQuickItem::widthValid() const

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

QQuickWindow *QQuickItem::window() const

返回渲染此项目的窗口。

项目在分配到场景中之前没有窗口。windowChanged() 信号会在项目进入场景和从场景中移除时发出通知。

[signal] void QQuickItem::windowChanged(QQuickWindow *window)

当项目的window 发生变化时会发出该信号。