Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

Описание Класса QDropEvent
[модуль QtGui]

Класс QDropEvent предоставляет сообщение, которое посылается при завершении операции drag and drop. Далее...

#include <QDropEvent>

Наследует QEvent и QMimeSource.

Наследуется QDragMoveEvent.

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

Дополнительные Унаследованные Члены


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

Класс QDropEvent предоставляет сообщение, которое посылается при завершении операции drag and drop.

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

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

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

См. также QMimeData, QDrag и Drag and Drop.


Описание Функций-Членов

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

Создает сообщение о перетаскивании, некоторого типа type, передаваемое при отпускании в некоторой точке pos в системе координат виджета-приемника.

Действие actions указывает, какой тип операции drag and drop может быть выполнен, а перетаскиваемые данные помещаются как закодированные MIME-данные в data.

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

void QDropEvent::acceptProposedAction ()

В качестве действия отпускания предложенное действие.

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

Qt::DropAction QDropEvent::dropAction () const

Возвращает действие, которое приемник, как ожидается, исполнить над данными. Если Ваше приложение понимает предложенное действие и способно обработать поставленные данные, вызовите acceptAction(); если Ваше приложение может обработать поставленные данные, но может выполнить только действие Копирования, вызовите accept().

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

Qt::KeyboardModifiers QDropEvent::keyboardModifiers () const

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

const QMimeData * QDropEvent::mimeData () const

Возвращает перемещенные в виджет данные вместе с информацией о типе MIME.

Qt::MouseButtons QDropEvent::mouseButtons () const

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

const QPoint & QDropEvent::pos () const

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

Qt::DropActions QDropEvent::possibleActions () const

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

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

Qt::DropAction QDropEvent::proposedAction () const

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

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

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

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

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

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

QWidget * QDropEvent::source () const

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

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

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


Copyright © 2005 Trolltech Trademarks
Qt 4.1.0
Hosted by uCoz