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 を返す場合は、accept またはignore event も返す必要がある。ただし、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 およびDrag and Dropも参照して ください。

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

このイベントハンドラをサブクラスで再実装することで、アイテムのドラッグ・リーブ・イベントを受け取ることができます。イベント情報はevent パラメータによって提供されます。

ドラッグ＆ドロップイベントは、このアイテムにItemAcceptsDrops フラグが設定されている場合にのみ提供されます。

イベントはデフォルトで受け付けられますので、この関数を再実装する場合は、イベントを明示的に受け付ける必要はありません。イベントを受け入れない場合は、event->ignore() を呼び出してください。

Drag およびDrag and Dropも参照して ください。

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

このイベントハンドラをサブクラスで再実装することで、アイテムのドラッグ移動イベントを受け取ることができます。イベント情報はevent パラメータによって提供されます。

ドラッグ＆ドロップイベントは、このアイテムにItemAcceptsDrops フラグが設定されている場合にのみ提供されます。

イベントはデフォルトで受け付けられますので、この関数を再実装する場合は、イベントを明示的に受け付ける必要はありません。イベントを受け入れない場合は、event->ignore() を呼び出してください。

Drag およびDrag and Dropも参照して ください。

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

このイベントハンドラは、アイテムのドロップイベントを受け取るためにサブクラスで再実装することができます。イベント情報はevent パラメータによって提供されます。

ドラッグ＆ドロップイベントは、このアイテムにItemAcceptsDrops フラグが設定されている場合にのみ提供されます。

イベントはデフォルトで受け付けられますので、この関数を再実装する場合は、イベントを明示的に受け付ける必要はありません。イベントを受け入れない場合は、event->ignore() を呼び出してください。

Drag およびDrag and Dropも参照して ください。

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

このアイテムから始まるItemのビジュアルツリーの詳細を再帰的にダンプします。

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

デバッグテクニックと GammaRayのQt Quick Inspectorも参照してください 。

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

updatePolish() を呼び出します。

これは、レイアウト（またはポジショナー）のように、implicitWidth とimplicitHeight の計算を PolishEvent を受け取るまで遅延させるアイテムに便利です。

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

この関数は 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)

このイベントハンドラをサブクラスで再実装することで、アイテムの hover-leave イベントを受け取ることができます。イベント情報は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 の Concepts - Visual Coordinatesも参照して ください。

[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 の Concepts - Visual Coordinatesも参照してください 。

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

シーンの座標系で与えられたpoint を、このアイテムの座標系内の等価な点にマッピングし、マッピングされた座標を返す。

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

アイテムが異なるシーンの一部である場合、マッピングには2つのシーンの相対位置が含まれる。

Qt Quick の Concepts - Visual Coordinatesも参照のこと 。

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

item の座標系で与え ら れたrect を、 こ の項目の座標系内の等価な矩形領域にマ ッ プ し 、 マ ッ プ し た矩形の値を返 し ます。

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

アイテムが異なるシーンの一部である場合、マッピングは2つのシーンの相対位置を含む。

item がnullptr の場合、シーンの座標系からrect をマッピングする。

Qt Quick の Concepts - Visual Coordinatesも参照のこと 。

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

シーンの座標系で与えられたrect を、このアイテムの座標系内の等価な矩形領域にマッピングし、マッピングされた矩形の値を返す。

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

アイテムが異なるシーンの一部である場合、マッピングには2つのシーンの相対位置が含まれる。

Qt Quick の Concepts - Visual Coordinatesも参照のこと 。

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

こ の項目の座標系で与え ら れたrect を、item の座標系内の等価な矩形領域にマ ッ プ し 、 マ ッ プ し た矩形の値を返す。

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

アイテムが異なるシーンの一部である場合、マッピングは2つのシーンの相対位置を含む。

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

Qt Quick の Concepts - Visual Coordinatesも参照のこと 。

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

このアイテムの座標系で与えられたrect を、シーンの座標系内の等価な矩形領域にマッピングし、マッピングされた矩形の値を返す。

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

アイテムが異なるシーンの一部である場合、マッピングには2つのシーンの相対位置が含まれる。

Qt Quick の Concepts - Visual Coordinatesも参照のこと 。

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

このアイテムの座標系で与えられたpoint を、グローバルスクリーン座標系内の等価点にマッピングし、マッピングされた座標を返す。

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

アイテムが異なるシーンの一部である場合、マッピングには2つのシーンの相対位置が含まれます。

例えば、これはQt Quick コンポーネントにポップアップを追加するのに役立つかもしれません。

Concepts - Visual Coordinates inQt 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 の Concepts - Visual Coordinatesも参照してください 。

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

このアイテムの座標系内の与えられたpoint を、シーンの座標系内の等価な点にマッピングし、マッピングされた座標を返す。

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

アイテムが異なるシーンの一部である場合、マッピングには2つのシーンの相対位置が含まれる。

Qt Quick の Concepts - Visual Coordinatesも参照のこと 。

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

指定された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::update() を呼び出すことができるのは、QQuickItem::ItemHasContents を指定したアイテムのみです。

[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

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

QQuickWindow *QQuickItem::window() const

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

アイテムは、シーンに割り当てられるまで、ウィンドウを持たない。windowChanged() シグナルは、アイテムがシーンに入力されたときと、シーンから削除されたときの両方の通知を提供します。

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

このシグナルは、アイテムのwindow 。