QGraphicsSceneDragDropEvent 类

QGraphicsSceneDragDropEvent 类提供了图形视图框架中的拖放事件。更多...

头文件	#include <QGraphicsSceneDragDropEvent>
CMake	find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake	QT += widgets
继承	QGraphicsSceneEvent

所有成员列表，包括继承成员

公共函数

virtual	~QGraphicsSceneDragDropEvent()
void	acceptProposedAction()
Qt::MouseButtons	buttons() const
Qt::DropAction	dropAction() const
const QMimeData *	mimeData() const
Qt::KeyboardModifiers	modifiers() const
QPointF	pos() const
Qt::DropActions	possibleActions() const
Qt::DropAction	proposedAction() const
QPointF	scenePos() const
QPoint	screenPos() const
void	setDropAction(Qt::DropAction action)
QWidget *	source() const

详细描述

QGraphicsView 继承了由 QWidget 提供的拖放功能。当它接收到拖放事件时，将其转换为 QGraphicsSceneDragDropEvent。

QGraphicsSceneDragDropEvent 存储了类型为 GraphicsSceneDragEnter、GraphicsSceneDragLeave、GraphicsSceneDragMove 或 GraphicsSceneDrop 的事件。

QGraphicsSceneDragDropEvent 包含鼠标光标在项、场景和屏幕坐标系中的位置；这些可以通过 pos()、scenePos() 和 screenPos() 来检索。

场景将事件发送到鼠标光标下接受放置的第一个 QGraphicsItem；一个图形项通过 setAcceptDrops() 设置为接受放置。

成员函数说明

`[虚拟 noexcept]` QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent()

销毁对象。

void QGraphicsSceneDragDropEvent::acceptProposedAction()

将提议的操作设置为已接受，即放置操作设置为提议的操作。这等于

setDropAction(proposedAction());

当使用此函数时，不应调用 accept()。

另请参阅 dropAction()，setDropAction() 和 proposedAction。

Qt::MouseButtons QGraphicsSceneDragDropEvent::buttons() const

返回一个 Qt::MouseButtons 值，指示在生成此鼠标事件时按下了哪些按钮。

另请参阅 Qt::MouseButtons。

Qt::DropAction QGraphicsSceneDragDropEvent::dropAction() const

返回在此次拖放中执行的操作。这应该由接收器设置，并由 QDrag::exec() 返回。

另请参阅 setDropAction() 和 acceptProposedAction。

const QMimeData *QGraphicsSceneDragDropEvent::mimeData() const

此函数返回事件的内容信息。

Qt::KeyboardModifiers QGraphicsSceneDragDropEvent::modifiers() const

返回在创建拖放事件时按下的键盘修饰符。

另请参阅 Qt::KeyboardModifiers。

QPointF QGraphicsSceneDragDropEvent::pos() const

返回事件相对于发送事件的视图的鼠标位置。

另请参阅 QGraphicsView，screenPos() 和 scenePos。

Qt::DropActions QGraphicsSceneDragDropEvent::possibleActions() const

返回可以由拖放产生可能的放置操作。

另请参阅 Qt::DropActions。

Qt::DropAction QGraphicsSceneDragDropEvent::proposedAction() const

返回建议的放置操作，即首选操作。该操作必须是 possibleActions() 定义的可能的操作之一。

另请参阅 Qt::DropAction 和 possibleActions。

QPointF QGraphicsSceneDragDropEvent::scenePos() const

返回场景坐标中鼠标的位置。

另请参阅 pos() 和 screenPos。

QPoint QGraphicsSceneDragDropEvent::screenPos() const

返回鼠标相对于屏幕的位置。

另请参阅 pos() 和 scenePos。

void QGraphicsSceneDragDropEvent::setDropAction(Qt::DropAction action)

此函数允许拖放集的接收者设置已执行的操作为action，这应该是在可能操作之一。如果使用此函数，请用accept()代替acceptProposedAction()。

另请参阅 dropAction()、accept()和possibleActions。

QWidget *QGraphicsSceneDragDropEvent::source() const

此函数返回创建QGraphicsSceneDragDropEvent的QGraphicsView。