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

このアイテムの座標系において、ポイント (x,y) で検出された、最初に表示されている子アイテムを返します。

そのような項目が存在しない場合は、nullptr を返します。

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

このアイテムの子要素を返します。

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

このメソッドを再実装して、このアイテムの子要素が受け取るポインタイベントをフィルタリングしてください。

このメソッドが呼び出されるのは、filtersChildMouseEvents()の値がtrue の場合のみです。

指定されたevent が指定された子item に渡されるべきでない場合はtrue を返し、それ以外の場合はfalse を返します。true を返す場合は、イベントの伝播を停止するか継続するかを示すために、event に対してaccept またはignore を実行する必要があります。ただし、event は常に親チェーン上のすべての子MouseEventFilterに送信されます。

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 がビューポート項目となり、カスタムコンテンツレンダリング項目は、現在表示されている領域の外側にあるシーングラフノードを省略することを選択できます。ItemObservesViewport フラグが設定されている場合、この領域は、ユーザーがFlickable内のコンテンツをスクロールするたびに変化します。

ネストされたビューポート項目の場合、clipRect() は、ItemIsViewport フラグが設定されているすべての祖先のboundingRectの交差部分であり、この項目の座標系にマッピングされます。

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 インスペクタも参照してください 。

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

updatePolish() を呼び出します

これは、PolishEvent を受信するまで `implicitWidth ` や `implicitHeight ` の計算を遅延させるレイアウト（またはポジショナー）などのアイテムにおいて有用です。

通常、例えばレイアウトに子アイテムが追加または削除された場合、暗黙的なサイズは直ちに計算されません（これは最適化のためです）。 場合によっては、子アイテムが追加された直後にレイアウトの暗黙的なサイズを照会したいこともあるでしょう。その場合は、暗黙的なサイズを照会する直前にこの関数を使用してください。

この関数は 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 への、このアイテムのジオメトリの変更を処理するために呼び出されます。2つのジオメトリが同一の場合は、何も行いません。

派生クラスは、その実装内で基底クラスのメソッドを呼び出す必要があります。

この関数は Qt 6.0 で導入されました。

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

アイテムをメモリ内のイメージに取り込みます。

取得処理は非同期で行われ、取得が完了するとQQuickItemGrabResult::ready()シグナルが発信されます。

targetSize を使用して、ターゲット画像のサイズを指定します。デフォルトでは、結果は item と同じサイズになります。

取得を開始できなかった場合、この関数は `null` を返します。

関連項目： QQuickWindow::grabWindow()。

[protected] bool QQuickItem::heightValid() const

height プロパティが明示的に設定されているかどうかを返します。

[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 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対位置が含まれます。

たとえば、Qt Quick コンポーネントにポップアップを追加する際に、これが役立つ場合があります。

Qt Quick の「概念 - 視覚座標」も参照してください 。

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

item の座標系における指定されたpoint を、このアイテムの座標系内の同等の点にマッピングし、マッピングされた座標を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対的な位置情報が含まれます。

item がnullptr の場合、これはシーンの座標系からのpoint をマッピングします。

Qt Quick の「概念 - 視覚座標」も参照してください 。

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

シーンの座標系における指定されたpoint を、このアイテムの座標系内の対応する点にマッピングし、マッピングされた座標を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対位置が含まれます。

Qt Quick の「概念 - 視覚座標」も参照してください 。

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

item の座標系における指定されたrect を、この項目の座標系内の対応する矩形領域にマッピングし、マッピングされた矩形の値を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対的な位置情報が含まれます。

item がnullptr の場合、これはシーンの座標系からのrect をマッピングします。

「Qt Quick 」の「概念 - 視覚座標」も参照してください 。

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

シーンの座標系における指定されたrect を、このアイテムの座標系内の対応する矩形領域にマッピングし、マッピングされた矩形の値を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対位置が含まれます。

Qt Quick の「概念 - 視覚座標」も参照してください 。

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

この項目の座標系における指定されたrect を、item の座標系内の同等の矩形領域にマッピングし、マッピングされた矩形の値を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対的な位置情報が含まれます。

item がnullptr の場合、rect はシーンの座標系にマッピングされます。

「Qt Quick 」の「概念 - 視覚座標」も参照してください 。

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

このアイテムの座標系における指定されたrect を、シーンの座標系内の対応する矩形領域にマッピングし、マッピングされた矩形の値を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対位置が含まれます。

Qt Quick の「概念 - 視覚座標」も参照してください 。

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

この項目の座標系における指定されたpoint を、グローバル画面座標系内の対応する点にマッピングし、マッピングされた座標を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対的な位置情報が含まれます。

たとえば、Qt Quick コンポーネントにポップアップを追加する際に、これが役立つ場合があります。

関連項目 : Qt Quick の「概念 - 視覚座標」を参照してください 。

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

この項目の座標系における指定されたpoint を、item の座標系内の対応する点にマッピングし、マッピングされた座標を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対的な位置情報が含まれます。

item がnullptr の場合、これはpoint をシーンの座標系にマッピングします。

Qt Quick の「概念 - 視覚座標」も参照してください 。

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

この項目の座標系における指定された「point 」を、シーンの座標系内の対応する点にマッピングし、マッピングされた座標を返します。

マッピングには、アイテムの以下のプロパティが使用されます：x 、y 、scale 、rotation 、transformOrigin 、およびtransform 。

アイテムが異なるシーンに属している場合、マッピングには2つのシーン間の相対的な位置情報が含まれます。

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 が存在することが保証されています。

この関数はGUIスレッド上で呼び出され、レンダリングスレッド（使用されている場合）の状態は不明です。オブジェクトを直接削除するのではなく、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 がfalseの場合、フィルタリングアイテムがグラブを奪うことがあります。例えば、Flickable は、ユーザーがビューポートの移動を開始したことを検出した場合、マウスのグラブを奪おうとすることがあります。

「keepMouseGrab()」も参照してください 。

void QQuickItem::setKeepTouchGrab(bool keep)

このアイテムによってグラブされたタッチポイントを、このアイテムのみが保持し続けるかどうかを設定します。

これは、あらかじめ定義されたジェスチャーの後に特定のタッチポイントを取得して保持したいアイテムに役立ちます。例えば、水平方向のタッチポイントの動きに関心のあるアイテムは、閾値を超えた時点で setKeepTouchGrab を true に設定できます。setKeepTouchGrab が true に設定されると、フィルタリングアイテムは関連するタッチポイントに反応しなくなります。

keep がfalseの場合、フィルタリングアイテムがタッチポイントの保持を奪う可能性があります。例えば、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)

この項目を、子要素のリスト内で指定された兄弟要素の直後の位置に移動します。子要素の順序は、視覚的な重ね合わせ順序と、タブフォーカスによるナビゲーション順序の両方に影響します。

両方の項目のz値が同じであると仮定すると、これにより「sibling 」がこの項目の下にレンダリングされます。

両方のアイテムで `activeFocusOnTab ` が `true` に設定されている場合、タブフォーカスの順序も変更され、`sibling ` がこのアイテムよりも先にフォーカスを受け取ることになります。

指定されたsibling は、このアイテムの兄弟要素でなければなりません。つまり、両者は同じ直系のparent を持つ必要があります。

「Qt Quick 」の「概念 - 視覚的な親」も参照してください 。

void QQuickItem::stackBefore(const QQuickItem *sibling)

この項目を、子要素のリスト内で指定された同階層の項目の直前の位置に移動します。子要素の順序は、視覚的な重ね順とタブフォーカスによるナビゲーション順序の両方に影響します。

両アイテムのz値が同じ場合、これによりsibling がこのアイテムの上方にレンダリングされます。

両方のアイテムで `activeFocusOnTab ` が `true` に設定されている場合、タブフォーカスの順序も変更され、`sibling ` がこのアイテムの後にフォーカスを受け取ることになります。

指定されたsibling は、このアイテムの兄弟要素でなければなりません。つまり、両者は同じ直接のparent を持つ必要があります。

「Qt Quick 」の「概念 - 視覚的な親」も参照してください 。

[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 インスタンスやその他のオブジェクトの値を読み取っても安全です。

QSGNode::markDirty() の呼び出しやノードの追加・削除など、QQuickItem::updatePaintNode() の呼び出しによってシーングラフに実際の変更が生じない場合、視覚的な結果は同一であるため、基盤となる実装ではシーンを再度レンダリングしないことを決定する場合があります。

関連項目： 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

width プロパティが明示的に設定されているかどうかを返します。

QQuickWindow *QQuickItem::window() const

このアイテムがレンダリングされるウィンドウを返します。

アイテムは、シーンに割り当てられるまではウィンドウを持ちません。windowChanged() シグナルは、アイテムがシーンに追加されたときと、シーンから削除されたときの両方で通知を行います。

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

この信号は、アイテムのwindow が変更されたときに発せられます。