Класс QDragMoveEvent
Класс QDragMoveEvent предоставляет событие, которое отправляется во время выполнения действия перетаскивания и выгрузки. Подробнее...
| Заголовок: | #include <QDragMoveEvent> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Наследует: | QDropEvent |
| Наследуется от: |
Публичные функции
| QDragMoveEvent(const QPoint &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = DragMove) | |
| virtual | ~QDragMoveEvent() |
| void | accept(const QRect &rectangle) |
| void | accept() |
| QRect | answerRect() const |
| void | ignore(const QRect &rectangle) |
| void | ignore() |
Подробное описание
Виджет будет получать события drag move повторно, пока перетаскивание находится внутри его границ, если он принимает события выгрузки и события входа. Виджет должен проверить событие, чтобы увидеть какой тип данных оно предоставляет, и вызвать функцию accept(), чтобы принять выгрузку, если это необходимо.
Прямоугольник, предоставленный функцией answerRect(), может использоваться для ограничения выгрузки определёнными частями виджета. Например, мы можем проверить, пересекается ли прямоугольник с геометрией определенного дочернего виджета и вызвать только acceptProposedAction(), если это так.
Обратите внимание, что этот класс наследует большую часть своей функциональности от QDropEvent.
См. также QDragEnterEvent, QDragLeaveEvent и QDropEvent.
Документация по функциям-членам
QDragMoveEvent::QDragMoveEvent(const QPoint &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = DragMove)
Создаёт QDragMoveEvent требуемого type, указывающего, что курсор находится в позиции pos внутри виджета.
Состояния мыши и клавиатуры задаются параметрами buttons и modifiers, а actions описывают типы операций перетаскивания и выгрузки, которые возможны. Данные перетаскивания передаются как информация в формате MIME в data.
Предупреждение: Не пытайтесь создавать QDragMoveEvent самостоятельно. Эти объекты полагаются на внутреннее состояние Qt.
[virtual] QDragMoveEvent::~QDragMoveEvent()
Уничтожает событие.
void QDragMoveEvent::accept(const QRect &rectangle)
То же самое, что и accept(), но также сообщает, что будущие перемещения также будут приемлемы, если они останутся в пределах rectangle, заданном на виджете. Это может улучшить производительность, но также может быть проигнорировано подлежащей системой.
Если прямоугольник пуст, события drag move будут отправляться непрерывно. Это полезно, если источник прокручивается в событии таймера.
void QDragMoveEvent::accept()
Это перегруженная функция.
Вызывает QDropEvent::accept().
QRect QDragMoveEvent::answerRect() const
Возвращает прямоугольник в виджете, где произойдёт выгрузка, если она принята. Вы можете использовать эту информацию для ограничения выгрузки определёнными местами на виджете.
void QDragMoveEvent::ignore(const QRect &rectangle)
Противное функции accept(const QRect&). Перемещения внутри rectangle неприемлемы и будут проигнорированы.
void QDragMoveEvent::ignore()
Это перегруженная функция.
Вызывает QDropEvent::ignore().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qdragmoveevent.html