
We bake cookies in your browser for a better experience. Using this site means that you consent.Read More
The following members of classQDropEventare part of the Qt compatibility layer. We advise against using them in new code.
| enum | Action { Copy, Link, Move, Private, UserAction } |
| void | accept(bool accept) |
| void | acceptAction(bool accept = true) |
| Action | action() const |
| virtual QByteArray | encodedData(const char * format) const |
| virtual const char * | format(int n = 0) const |
| virtual bool | provides(const char * mimeType) const |
| void | setPoint(const QPoint & point) |
When a drag and drop action is completed, the target is expected to perform an action on the data provided by the source. This will be one of the following:
| Constant | Value | Description |
|---|---|---|
QDropEvent::Copy | 0 | The default action. The source simply uses the data provided in the operation. |
QDropEvent::Link | 1 | The source should somehow create a link to the location specified by the data. |
QDropEvent::Move | 2 | The source should somehow move the object from the location specified by the data to a new location. |
QDropEvent::Private | 3 | The target has special knowledge of the MIME type, which the source should respond to in a similar way to a Copy. |
QDropEvent::UserAction | Private | The source and target can co-operate using special actions. This feature is not currently supported. |
The Link and Move actions only makes sense if the data is a reference, for example, text/uri-list file lists (seeQUriDrag).
CallsetAccepted(accept) instead.
Call this to indicate that the action described byaction() is accepted (i.e. ifaccept is true, which is the default), not merely the default copy action. If you call acceptAction(true), there is no need to also call accept(true).
UsedropAction() instead.
The table below shows the correspondance between the return type of action() and the return type ofdropAction().
| Old enum value | New enum value |
|---|---|
| QDropEvent::Copy | Qt::CopyAction |
| QDropEvent::Move | Qt::MoveAction |
| QDropEvent::Link | Qt::LinkAction |
| other | Qt::CopyAction |
[virtual]QByteArray QDropEvent::encodedData(constchar * format) constReimplemented fromQMimeSource::encodedData().
Returns a byte array containing the drag's data, informat.
data() normally needs to get the data from the drag source, which is potentially very slow, so it's advisable to call this function only if you're sure that you will need the data in that particularformat.
The resulting data will have a size of 0 if the format was not available.
See alsoformat() andQByteArray::size().
[virtual]constchar * QDropEvent::format(int n = 0) constReimplemented fromQMimeSource::format().
Returns a string describing one of the available data types for this drag. Common examples are "text/plain" and "image/gif". Ifn is less than zero or greater than the number of available data types, format() returns 0.
This function is provided mainly for debugging. Most drop targets will useprovides().
[virtual]bool QDropEvent::provides(constchar * mimeType) constReimplemented fromQMimeSource::provides().
Returns true if this event provides formatmimeType; otherwise returns false.
See alsodata().
Sets the drop to happen at the givenpoint. You do not normally need to use this as it will be set internally before your widget receives the drop event.
© 2016 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of theGNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.