对象选择器 QML 类型
ObjectPicker 类实例化了一个可以通过选择过程与之交互的组件。有关更多信息,请点击这里。
导入语句 | import Qt3D.Render 2.7 |
实例化 | QObjectPicker |
属性
- containsMouse : bool
- dragEnabled : bool
- hoverEnabled : bool
- pressed : bool
- priority : int
信号
- clicked(PickEvent pick)
- 进入()
- 退出()
- moved(PickEvent pick)
- pressed(PickEvent pick)
- released(PickEvent pick)
详细信息
对于每个视口和相机的组合,选择会将射线投射到场景中以找到与射线相交的实体的边界体积。边界体积是通过使用几何体中定义的边界体积位置属性指定的属性缓冲区中的值来计算的。
当由 pickAttribute 属性定义的边界体积与射线相交时,将发出 pressed()、released()、clicked()、moved()、entered() 和 exited() 信号。
大多数信号携带一个 PickEvent 实例。如果 PickingSettings.pickMode 设置为 PickingSettings.TrianglePicking,实际的选择参数类型将是 PickTriangleEvent。
在鼠标按下和释放时执行选择查询。如果启用拖动,则在按下任意按钮时鼠标移动的每个步骤也会进行查询。如果启用悬停,则在每次鼠标移动时都会发生查询,即使没有按按钮也是如此。
注意:要在 QtQuick 中接收悬停事件,hoverEnabled 属性中的 Scene3D 也必须设置。
注意:不应共享此组件的实例,不遵守该条件很可能会导致未定义的行为。
注意:如果相机远平面值大于 ~100 000,它将影响选择并产生由于浮点精度引起的错误结果。
另请参阅 选取设置,几何体,属性,选取事件,选取三角形事件,以及 无选取。
属性文档
containsMouse : bool |
指定对象选取器是否包含鼠标
dragEnabled : bool |
hoverEnabled : bool |
指定是否启用悬停
pressed : bool |
指定对象选取器是否当前按下
信号文档
clicked(选取事件 pick) |
当由pickAttribute属性定义的边界体积与鼠标点击时的射线相交时,发出该信号。交点信息可通过pick参数访问。
注意:相应的处理程序是onClicked
。
进入() |
当由pickAttribute属性定义的边界体积与鼠标进入体积时的射线相交时,发出该信号。
注意:相应的处理程序是onEntered
。
退出() |
当由pickAttribute属性定义的边界体积与射线离开体积时的射线相交时,发出该信号。
注意:相应的处理程序是onExited
。
moved(选取事件 pick) |
在按住按钮并移动鼠标时,当由pickAttribute属性定义的边界体积与射线相交时,发出此信号。可通过pick参数访问交点信息。
注意:相应的处理程序是onMoved
。
pressed(选取事件 pick) |
当由pickAttribute属性定义的边界体积与鼠标按下时的射线相交时,发出该信号。可通过pick参数访问交点信息。
注意:相应的处理程序是onPressed
。
released(选取事件 pick) |
当由pickAttribute属性定义的边界体积与鼠标释放时的射线相交时,发出此信号。可通过pick参数访问交点信息。
注意:相应的处理程序是onReleased
。
© 2024 Qt公司版权所有。此处包含的文档贡献是各自所有者的版权。提供的文档受免费软件基金会发布的GNU自由文档许可证版本1.3条款约束。Qt及其相关标志是芬兰的Qt公司及其它全球国家的商标。所有其他商标均为各自所有者财产。