|  | Home · Overviews · Examples |

# QDropEvent Class Reference
[com.trolltech.qt.gui module]

The `QDropEvent` class provides an event which is sent when a drag and drop action is completed. More...

Inherits `QEvent`.

Inherited by `QDragMoveEvent`.

## Detailed Description

The `QDropEvent` class provides an event which is sent when a drag and drop action is completed.

When a widget accepts drop events, it will receive this event if it has accepted the most recent `QDragEnterEvent` or `QDragMoveEvent` sent to it.

The drop event contains a proposed action, available from `proposedAction`, for the widget to either accept or ignore. If the action can be handled by the widget, you should call the `acceptProposedAction` function. Since the proposed action can be a combination of `Qt::DropAction` values, it may be useful to either select one of these values as a default action or ask the user to select their preferred action.

If the proposed drop action is not suitable, perhaps because your custom widget does not support that action, you can replace it with any of the possible drop actions by calling `setDropAction` with your preferred action. If you set a value that is not present in the bitwise OR combination of values returned by `possibleActions`, the default copy action will be used. Once a replacement drop action has been set, call `accept` instead of `acceptProposedAction` to complete the drop operation.

The `mimeData` function provides the data dropped on the widget in a `QMimeData` object. This contains information about the MIME type of the data in addition to the data itself.

See also `QMimeData`, `QDrag`, and Drag and Drop.