Класс QDropEvent

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

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

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

• 6 открытых функций, унаследованных от QEvent

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QEvent
• 1 статический открытый член, унаследованный от QEvent

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

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

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

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

Если предлагаемое действие падения не подходит, например, потому что ваш пользовательский виджет не поддерживает это действие, вы можете заменить его любым из возможных действий падения, вызвав setDropAction() с вашим предпочтительным действием. Если вы зададите значение, отсутствующее в битовом ИЛИ комбинации значений, возвращаемых 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, Type type = Drop)

Создает событие падения определенного type, соответствующее падению в точке, указанной 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

Возвращает комбинацию возможных действий падения, объединенных по битовому ИЛИ.

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

Qt::DropAction QDropEvent::proposedAction() const

Возвращает предложенное действие падения.

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

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

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

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

После задания замещающего действия падения вызовите accept() вместо acceptProposedAction().

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

QObject *QDropEvent::source() const

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

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

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