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を返します。

そうでない場合は false を返します。 コンポーネントが完成するまで処理を遅らせたいことがよくあります。

componentComplete() も参照 。

bool QQuickItem::isFocusScope() const

このアイテムがフォーカススコープであれば真を、そうでなければ偽を返します。

[virtual] bool QQuickItem::isTextureProvider() const

この項目がテクスチャプロバイダであれば真を返します。デフォルトの実装は 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()も参照してください 。

bool QQuickItem::keepTouchGrab() const

このアイテムによって掴まれたタッチポイントを、このアイテムだけに残すかどうかを返します。

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 。

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

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

Concepts - Visual Coordinates in 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 をマッピングする。

Concepts - Visual Coordinates in 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 コンポーネントにポップアップを追加するのに役立ちます。

Concepts - Visual Coordinates in 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 をシーンの座標系にマッピングする。

Concepts - Visual Coordinates in 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 に設定します。 このメソッドは、widthとheightに関する既存のバインディングを保持します。したがって、バインディングの再実行をトリガーする変更は、設定された値を上書きします。

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 の視覚的な親」も参照してください 。

[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 が変更された時に発行されます。