Класс 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().