QGraphicsSceneDragDropEvent Class
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()`를 통해 드롭을 허용하도록 설정됩니다.
멤버 함수 설명서
[virtual 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
이 함수는 이벤트의 MIME 데이터를 반환합니다.
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
씬 좌표계에서 마우스의 위치를 반환합니다.
QPoint QGraphicsSceneDragDropEvent::screenPos() const
화면을 기준으로 한 마우스의 위치를 반환합니다.
void QGraphicsSceneDragDropEvent::setDropAction(Qt::DropAction action)
이 함수를 사용하면 드롭의 수신자가 수행된 드롭 동작을 ` action`로 설정할 수 있으며, 이 값은 ` possible actions` 중 하나여야 합니다. 이 함수를 사용하는 경우 ` acceptProposedAction() ` 대신 ` accept() `를 호출하십시오.
dropAction(), accept(), possibleActions()도 참조하십시오 .
QWidget *QGraphicsSceneDragDropEvent::source() const
이 함수는 ` QGraphicsSceneDragDropEvent`을 생성한 ` QGraphicsView `을 반환합니다.
© 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.
