diff options
Diffstat (limited to 'doc/src/examples/draggableicons.qdoc')
-rw-r--r-- | doc/src/examples/draggableicons.qdoc | 90 |
1 files changed, 0 insertions, 90 deletions
diff --git a/doc/src/examples/draggableicons.qdoc b/doc/src/examples/draggableicons.qdoc deleted file mode 100644 index f69dbc4b3d..0000000000 --- a/doc/src/examples/draggableicons.qdoc +++ /dev/null @@ -1,90 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). -** Contact: http://www.qt-project.org/ -** -** This file is part of the documentation of the Qt Toolkit. -** -** $QT_BEGIN_LICENSE:FDL$ -** GNU Free Documentation License -** Alternatively, this file may be used under the terms of the GNU Free -** Documentation License version 1.3 as published by the Free Software -** Foundation and appearing in the file included in the packaging of -** this file. -** -** Other Usage -** Alternatively, this file may be used in accordance with the terms -** and conditions contained in a signed written agreement between you -** and Nokia. -** -** -** -** -** -** $QT_END_LICENSE$ -** -****************************************************************************/ - -/*! - \example draganddrop/draggableicons - \title Draggable Icons Example - - The Draggable Icons example shows how to drag and drop image data between widgets - in the same application, and between different applications. - - \image draggableicons-example.png - - In many situations where drag and drop is used, the user starts dragging from - a particular widget and drops the payload onto another widget. In this example, - we subclass QLabel to create labels that we use as drag sources, and place them - inside \l{QWidget}s that serve as both containers and drop sites. - - In addition, when a drag and drop operation occurs, we want to send more than - just an image. We also want to send information about where the user clicked in - the image so that the user can place it precisely on the drop target. This level - of detail means that we must create a custom MIME type for our data. - - \section1 DragWidget Class Definition - - The icon widgets that we use to display icons are subclassed from QLabel: - - \snippet examples/draganddrop/draggableicons/dragwidget.h 0 - - Since the QLabel class provides most of what we require for the icon, we - only need to reimplement the \l QWidget::mousePressEvent() to provide - drag and drop facilities. - - \section1 DragWidget Class Implementation - - The \c DragWidget constructor sets an attribute on the widget that ensures - that it will be deleted when it is closed: - - \snippet examples/draganddrop/draggableicons/dragwidget.cpp 0 - - To enable dragging from the icon, we need to act on a mouse press event. - We do this by reimplementing \l QWidget::mousePressEvent() and setting up - a QDrag object. - - \snippet examples/draganddrop/draggableicons/dragwidget.cpp 1 - - Since we will be sending pixmap data for the icon and information about the - user's click in the icon widget, we construct a QByteArray and package up the - details using a QDataStream. - - For interoperability, drag and drop operations describe the data they contain - using MIME types. In Qt, we describe this data using a QMimeData object: - - \snippet examples/draganddrop/draggableicons/dragwidget.cpp 2 - - We choose an unofficial MIME type for this purpose, and supply the QByteArray - to the MIME data object. - - The drag and drop operation itself is handled by a QDrag object: - - \snippet examples/draganddrop/draggableicons/dragwidget.cpp 3 - - Here, we pass the data to the drag object, set a pixmap that will be shown - alongside the cursor during the operation, and define the position of a hot - spot that places the position of this pixmap under the cursor. - -*/ |