Класс QDropEvent

Класс QDropEvent предоставляет событие, которое отправляется при завершении операции перетаскивания и опускания. Подробнее...

• Список всех членов, включая наследуемые

Открытые функции

Подробное описание

Когда виджет принимает события опускания, он получит это событие, если он принял последнее событие QDragEnterEvent или QDragMoveEvent, отправленное ему.

Событие опускания содержит предлагаемое действие, доступное из proposedAction(), которое виджет может принять или проигнорировать. Если действие может быть обработано виджетом, вы должны вызвать функцию acceptProposedAction(). Поскольку предлагаемое действие может быть комбинацией значений Qt::DropAction, может быть полезно либо выбрать одно из этих значений в качестве действия по умолчанию, либо попросить пользователя выбрать предпочитаемое действие.

Если предлагаемое действие опускания не подходит, возможно, потому что ваш пользовательский виджет не поддерживает это действие, вы можете заменить его любым из возможных действий опускания, вызвав setDropAction() с вашим предпочтительным действием. Если вы установите значение, отсутствующее в побитовой операции OR комбинации значений, возвращаемых possibleActions(), будет использоваться действие копирования по умолчанию. После того, как действие опускания замены установлено, вызовите accept() вместо acceptProposedAction() для завершения операции опускания.

Функция mimeData() предоставляет данные, опущенные на виджет, в объекте QMimeData. Он содержит информацию о MIME-типе данных, помимо самих данных.

См. также QMimeData, QDrag и Перетаскивание и опускание.

Документация по функциям-членам

QDropEvent::QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop)

Создаёт событие опускания определённого типа, соответствующего опусканию в точку, указанную pos, в системе координат целевого виджета.

actions указывают, какие типы операций перетаскивания и опускания могут быть выполнены, а данные перетаскивания хранятся как данные в формате MIME в data.

Состояния кнопок мыши и модификаторов клавиатуры в момент опускания задаются buttons и modifiers.

void QDropEvent::acceptProposedAction()

Устанавливает действие опускания в предлагаемое действие.

См. также setDropAction(), proposedAction() и accept().

Qt::DropAction QDropEvent::dropAction() const

Возвращает действие, которое должно быть выполнено над данными целевым объектом. Оно может отличаться от действия, предоставленного в proposedAction(), если вы вызвали setDropAction() для явного выбора действия опускания.

См. также setDropAction().

Qt::KeyboardModifiers QDropEvent::keyboardModifiers() const

Возвращает нажатые клавиши-модификаторы.

const QMimeData *QDropEvent::mimeData() const

Возвращает данные, которые были опущены на виджет, и информацию об ассоциированном MIME-типе.

Qt::MouseButtons QDropEvent::mouseButtons() const

Возвращает нажатые кнопки мыши.

QPoint QDropEvent::pos() const

Возвращает положение, где было выполнено опускание.

const QPointF &QDropEvent::posF() const

Возвращает положение, где было выполнено опускание.

Qt::DropActions QDropEvent::possibleActions() const

Возвращает комбинацию возможных действий опускания (побитовая операция OR).

См. также dropAction().

Qt::DropAction QDropEvent::proposedAction() const

Возвращает предлагаемое действие опускания.

См. также dropAction().

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

Устанавливает действие, которое должно быть выполнено над данными целевым объектом. Используйте это для переопределения предлагаемого действия одним из возможных действий.

Если вы установите действие опускания, которое не является одним из возможных действий, операция перетаскивания и опускания по умолчанию будет использовать действие копирования.

После того, как вы предоставили действие опускания, вызовите accept() вместо acceptProposedAction().

См. также dropAction().

QObject *QDropEvent::source() const

Если источником операции перетаскивания является виджет в этом приложении, эта функция возвращает этот источник; в противном случае она возвращает nullptr. Источником операции является первый параметр объекта QDrag, используемого для инициализации перетаскивания.

Это полезно, если ваш виджет нуждается в особом поведении при перетаскивании к самому себе.

См. также QDrag::QDrag().