このページでは

ObjectPicker QML Type

ObjectPickerクラスは、ピッキングと呼ばれる処理によってエンティティと対話するために使用できるコンポーネントをインスタンス化します。詳細...

Import Statement: import Qt3D.Render 2.11
In C++: QObjectPicker
Status: Deprecated

プロパティ

信号

詳細説明

ビューポートとカメラの組み合わせごとに、picking はシーンを通してレイをキャストし、バウンディングボリュームがレイと交差するエンティティを見つけます。バウンディング ボリュームは、ジオメトリの boundingVolumePositionAttribute で指定されたアトリビュート バッファの値を使用して計算されます。

シグナルpressed()、released()、clicked()、moved()、entered()、exited() は、pickAttribute プロパティで定義されたバウンディング ボリュームがレイと交差するときに発行されます。

ほとんどのシグナルは、PickEvent インスタンスを運びます。PickingSettings.pickMode がPickingSettings.TrianglePicking に設定されている場合、pick パラメータの実際のタイプはPickTriangleEvent になります。

ピッククエリは、マウスを押したときと離したときに実行されます。ドラッグが有効な場合、いずれかのボタンが押されている間、マウスの各移動でもクエリが実行されます。ホバーが有効な場合、ボタンが押されていなくても、マウスが動くたびにクエリが発生します。

:QtQuick でホバー・イベントを受信するには、Scene3DhoverEnabled プロパティも設定する必要があります。

注: このコンポーネントのインスタンスは共有されるべきではありません。この条件を守らないと、ほとんどの場合、未定義の動作になります。

注意 : カメラ遠平面値はピッキングに影響し、~100 000 より大きい場合、浮動小数点精度のために不正な結果を生成します。

PickingSettings,Geometry,Attribute,PickEvent,PickTriangleEvent,NoPickingも参照して ください。

プロパティ・ドキュメンテーション

containsMouse : bool [read-only]

オブジェクトピッカーにマウスが含まれているかどうかを指定します。

dragEnabled : bool

hoverEnabled : bool

ホバーが有効かどうかを指定する

pressed : bool [read-only]

オブジェクトピッカーが現在押されているかどうかを指定する。

priority : int

PickingSettings.pickResultMode がPickingSettings.PriorityPick に設定されているときに、ピック結果を優先順位でフィルタリングするときに使用する優先順位。

シグナルのドキュメント

clicked(PickEvent pick)

このシグナルは、pickAttributeプロパティで定義されたバウンディングボリュームが、マウスクリックでレイと交差したときに発行されます。交差情報は、pick パラメータからアクセスできます。

注意: 対応するハンドラはonClicked です。

entered()

このシグナルは、pickAttributeプロパティで定義されたバウンディングボリュームが、そのボリュームに入るマウス上のレイと交差した時に発行されます。

注意: 対応するハンドラはonEntered です。

exited()

このシグナルは、pickAttributeプロパティで定義されたバウンディングボリュームが、ボリュームから出るレイ上のレイと交差したときに発行されます。

注意: 対応するハンドラはonExited です。

moved(PickEvent pick)

このシグナルは、pickAttributeプロパティで定義されたバウンディングボリュームが、ボタンが押された状態でのマウス移動でレイと交差したときに発行されます。交差情報は、pick パラメータからアクセスできます。

注意: 対応するハンドラはonMoved です。

pressed(PickEvent pick)

このシグナルは、pickAttributeプロパティで定義されたバウンディングボリュームが、マウスを押した時にレイと交差した時に発行されます。交差情報は、pick パラメータからアクセスできます。

注意: 対応するハンドラはonPressed です。

released(PickEvent pick)

このシグナルは、pickAttributeプロパティで定義されたバウンディングボリュームが、マウスを離した時にレイと交差した時に発行されます。交差情報は、pick パラメータからアクセスできます。

注意: 対応するハンドラはonReleased です。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.