内容

• 特性
• 公共函数
• 公共槽
• 信号
• 静态公共成员
• 详细描述

QObjectPicker Class

( Qt3DRender::QObjectPicker )

The QObjectPicker class instantiates a component that can be used to interact with a QEntity by a process known as picking. 更多...

头：	#include <QObjectPicker>
qmake:	QT += 3drender
Since:	Qt 5.6
实例化：	ObjectPicker
继承：	Qt3DCore::QComponent

• 所有成员列表，包括继承成员
• 过时成员

特性

• containsMouse : const bool
• dragEnabled : bool
• hoverEnabled : bool
• pressed : const bool

• 1 特性继承自 Qt3DCore::QComponent
• 3 特性继承自 Qt3DCore::QNode
• 1 特性继承自 QObject

公共函数

	QObjectPicker (Qt3DCore::QNode * parent = nullptr)
bool	containsMouse () const
bool	isDragEnabled () const
bool	isHoverEnabled () const
bool	isPressed () const

• 2 公共函数继承自 Qt3DCore::QComponent
• 13 公共函数继承自 Qt3DCore::QNode
• 31 公共函数继承自 QObject

公共槽

void	setDragEnabled (bool dragEnabled )
void	setHoverEnabled (bool hoverEnabled )

• 1 公共槽继承自 Qt3DCore::QComponent
• 3 公共槽继承自 Qt3DCore::QNode
• 1 公共槽继承自 QObject

信号

void	clicked (Qt3DRender::QPickEvent * pick )
void	containsMouseChanged (bool containsMouse )
void	dragEnabledChanged (bool dragEnabled )
void	entered ()
void	exited ()
void	hoverEnabledChanged (bool hoverEnabled )
void	moved (Qt3DRender::QPickEvent * pick )
void	pressed (Qt3DRender::QPickEvent * pick )
void	pressedChanged (bool pressed )
void	released (Qt3DRender::QPickEvent * pick )

• 3 信号继承自 Qt3DCore::QComponent
• 4 信号继承自 Qt3DCore::QNode
• 2 信号继承自 QObject

静态公共成员

const QMetaObject

staticMetaObject

• 9 静态公共成员继承自 QObject

额外继承成员

• 2 保护函数继承自 Qt3DCore::QNode
• 9 保护函数继承自 QObject

详细描述

The QObjectPicker class instantiates a component that can be used to interact with a QEntity by a process known as picking.

For every combination of viewport and camera, picking casts a ray through the scene to find entities who's bounding volume intersects the ray. The bounding volume is computed using the values in the attribute buffer specified by the boundingVolumePositionAttribute of the geometry.

The signals pressed (), released (), clicked (), moved (), entered ()，和 exited () are emitted when the bounding volume defined by the pickAttribute property intersects with a ray.

Most signals carry a QPickEvent instance. If QPickingSettings::pickMode() is set to QPickingSettings::TrianglePicking , the actual type of the pick parameter will be QPickTriangleEvent .

Pick queries are performed on mouse press and mouse release. If drag is enabled, queries also happen on each mouse move while any button is pressed. If hover is enabled, queries happen on every mouse move even if no button is pressed.

For generalised ray casting queries, see Qt3DRender::QRayCaster and Qt3DRender::QScreenRayCaster .

注意： Instances of this component shouldn't be shared, not respecting that condition will most likely result in undefined behavior.

另请参阅 Qt3DRender::QPickingSettings , Qt3DRender::QGeometry , Qt3DRender::QAttribute , Qt3DRender::QPickEvent ，和 Qt3DRender::QPickTriangleEvent .

特性文档编制

containsMouse : const bool

Specifies if the object picker currently contains the mouse

访问函数：

bool	containsMouse () const

通知程序信号：

void	containsMouseChanged (bool containsMouse )

dragEnabled : bool

Specifies if drag is enabled

访问函数：

bool	isDragEnabled () const
void	setDragEnabled (bool dragEnabled )

通知程序信号：

void	dragEnabledChanged (bool dragEnabled )

hoverEnabled : bool

Specifies if hover is enabled

访问函数：

bool	isHoverEnabled () const
void	setHoverEnabled (bool hoverEnabled )

通知程序信号：

void	hoverEnabledChanged (bool hoverEnabled )

pressed : const bool

Specifies if the object picker is currently pressed

访问函数：

bool	isPressed () const

通知程序信号：

void	pressedChanged (bool pressed )

成员函数文档编制

QObjectPicker:: QObjectPicker ( Qt3DCore::QNode * parent = nullptr)

Default constructs an instance of QObjectPicker.

[signal] void QObjectPicker:: clicked ( Qt3DRender::QPickEvent * pick )

This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on a mouse click the QPickEvent pick contains details of the event.

bool QObjectPicker:: containsMouse () const

Returns true if the object picker currently contains the mouse

注意： getter 函数对于特性 containsMouse .

[signal] void QObjectPicker:: entered ()

This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on the mouse entering the volume.

[signal] void QObjectPicker:: exited ()

This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on the ray exiting the volume.

bool QObjectPicker:: isDragEnabled () const

Returns true if dragging is enabled

注意： getter 函数对于特性 dragEnabled .

bool QObjectPicker:: isHoverEnabled () const

Returns true if hover enabled

注意： getter 函数对于特性 hoverEnabled .

[signal] void QObjectPicker:: moved ( Qt3DRender::QPickEvent * pick )

This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on a mouse move with a button pressed the QPickEvent pick contains details of the event.

[signal] void QObjectPicker:: pressed ( Qt3DRender::QPickEvent * pick )

This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on a mouse press the QPickEvent pick contains details of the event.

[signal] void QObjectPicker:: released ( Qt3DRender::QPickEvent * pick )

This signal is emitted when the bounding volume defined by the pickAttribute property intersects with a ray on a mouse release the QPickEvent pick contains details of the event.

[slot] void QObjectPicker:: setDragEnabled ( bool dragEnabled )

设置 dragEnabled Property to dragEnabled

注意： setter 函数对于特性 dragEnabled .

另请参阅 isDragEnabled ().

[slot] void QObjectPicker:: setHoverEnabled ( bool hoverEnabled )

设置 hoverEnabled Property to hoverEnabled

注意： setter 函数对于特性 hoverEnabled .

另请参阅 isHoverEnabled ().