Класс QDragMoveEvent
Класс QDragMoveEvent предоставляет событие, которое отправляется во время выполнения действия перетаскивания и отпускания. Подробнее...
| Заголовок: | #include <QDragMoveEvent> |
| 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() |
Подробное описание
Виджет будет получать события QDragMoveEvent многократно, пока перетаскивание происходит внутри его границ, если он принимает события опускания drop events и события входа enter events. Виджет должен проверить событие, чтобы увидеть какой тип данных он предоставляет, и вызвать функцию 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 требуемого типа, указывающее, что курсор находится в позиции pos внутри виджета.
Состояния мыши и клавиатуры задаются параметрами buttons и modifiers, а actions описывают типы операций перетаскивания и опускания, которые возможны. Данные перетаскивания передаются в виде MIME-кодированной информации в data.
Предупреждение: Не пытайтесь создавать QDragMoveEvent самостоятельно. Эти объекты полагаются на внутреннее состояние Qt.
[virtual] QDragMoveEvent::~QDragMoveEvent()
Уничтожает событие.
void QDragMoveEvent::accept(const QRect &rectangle)
То же, что и accept(), но также уведомляет, что будущие перемещения также будут приемлемы, если они останутся в пределах заданного прямоугольника rectangle на виджете. Это может улучшить производительность, но также может быть проигнорировано основной системой.
Если прямоугольник пустой, события QDragMoveEvent будут отправляться непрерывно. Это полезно, если источник прокручивается в событии таймера.
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-5.15/qdragmoveevent.html