Add Qt3 development HEAD version

1 files changed, 567 insertions, 0 deletions

diff --git a/src/kernel/qclipboard.cpp b/src/kernel/qclipboard.cpp
new file mode 100644
index 0000000..b02d1ec
--- /dev/null
+++ b/src/kernel/qclipboard.cpp
@@ -0,0 +1,567 @@
+/****************************************************************************
+**
+** Implementation of QClipboard class
+**
+** Created : 960430
+**
+** Copyright (C) 1992-2008 Trolltech ASA.  All rights reserved.
+**
+** This file is part of the kernel module of the Qt GUI Toolkit.
+**
+** This file may be used under the terms of the GNU General
+** Public License versions 2.0 or 3.0 as published by the Free
+** Software Foundation and appearing in the files LICENSE.GPL2
+** and LICENSE.GPL3 included in the packaging of this file.
+** Alternatively you may (at your option) use any later version
+** of the GNU General Public License if such license has been
+** publicly approved by Trolltech ASA (or its successors, if any)
+** and the KDE Free Qt Foundation.
+**
+** Please review the following information to ensure GNU General
+** Public Licensing requirements will be met:
+** http://trolltech.com/products/qt/licenses/licensing/opensource/.
+** If you are unsure which license is appropriate for your use, please
+** review the following information:
+** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
+** or contact the sales department at sales@trolltech.com.
+**
+** This file may be used under the terms of the Q Public License as
+** defined by Trolltech ASA and appearing in the file LICENSE.QPL
+** included in the packaging of this file.  Licensees holding valid Qt
+** Commercial licenses may use this file in accordance with the Qt
+** Commercial License Agreement provided with the Software.
+**
+** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
+** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
+** herein.
+**
+**********************************************************************/
+
+#include "qclipboard.h"
+
+#ifndef QT_NO_CLIPBOARD
+
+#include "qapplication.h"
+#include "qapplication_p.h"
+#include "qdragobject.h"
+#include "qpixmap.h"
+
+/*!
+    \class QClipboard qclipboard.h
+    \brief The QClipboard class provides access to the window system clipboard.
+
+    \ingroup io
+    \ingroup environment
+    \mainclass
+
+    The clipboard offers a simple mechanism to copy and paste data
+    between applications.
+
+    QClipboard supports the same data types that QDragObject does, and
+    uses similar mechanisms. For advanced clipboard usage
+    read \link dnd.html the drag-and-drop documentation\endlink.
+
+    There is a single QClipboard object in an application, and you can
+    access it using QApplication::clipboard().
+
+    Example:
+    \code
+    QClipboard *cb = QApplication::clipboard();
+
+    // Copy text from the clipboard (paste)
+    QString text = cb->text(QClipboard::Clipboard);
+    if ( !text.isNull() )
+	qDebug( "The clipboard contains: " + text );
+
+    // Copy text into the clipboard
+    cb->setText( "This text can be pasted by other programs",
+		 QClipboard::Clipboard );
+    \endcode
+
+    QClipboard features some convenience functions to access common data
+    types: setText() allows the exchange of Unicode text and
+    setPixmap() and setImage() allows the exchange of QPixmaps
+    and QImages between applications. The setData() function is the
+    ultimate in flexibility: it allows you to add any QMimeSource into the
+    clipboard. There are corresponding getters for each of these, e.g.
+    text(), image() and pixmap().
+
+    You can clear the clipboard by calling clear().
+
+
+    \section1 Platform Specific Information
+
+    \section2 X11
+
+    \list
+
+    \i The X11 Window System has the concept of a separate selection
+    and clipboard.  When text is selected, it is immediately available
+    as the global mouse selection.  The global mouse selection may
+    later be copied to the clipboard.  By convention, the middle mouse
+    button is used to paste the global mouse selection.
+
+    \i X11 also has the concept of ownership; if you change the
+    selection within a window, X11 will only notify the owner and the
+    previous owner of the change, i.e. it will not notify all
+    applications that the selection or clipboard data changed.
+
+    \i Lastly, the X11 clipboard is event driven, i.e. the clipboard
+    will not function properly if the event loop is not running.
+    Similarly, it is recommended that the contents of the clipboard
+    are stored or retrieved in direct response to user-input events,
+    e.g. mouse button or key presses and releases.  You should not
+    store or retrieve the clipboard contents in response to timer or
+    non-user-input events.
+
+    \endlist
+
+    \section2 Windows
+
+    \list
+
+    \i Microsoft Windows does not support the global mouse selection;
+    it only supports the global clipboard, e.g. Windows only adds text
+    to the clipboard when an explicit copy or cut is made.
+
+    \i Windows does not have the concept of ownership; the clipboard
+    is a fully global resource so all applications are notified of
+    changes.
+
+    \endlist
+
+    See the multiclip example in the \e{Qt Designer} examples
+    directory for an example of a multiplatform clipboard application
+    that also demonstrates selection handling.
+*/
+
+
+/*!
+    \internal
+
+    Constructs a clipboard object.
+
+    Do not call this function.
+
+    Call QApplication::clipboard() instead to get a pointer to the
+    application's global clipboard object.
+
+    There is only one clipboard in the window system, and creating
+    more than one object to represent it is almost certainly an error.
+*/
+
+QClipboard::QClipboard( QObject *parent, const char *name )
+    : QObject( parent, name )
+{
+    // nothing
+}
+
+#ifndef Q_WS_WIN32
+/*!
+    \internal
+
+    Destroys the clipboard.
+
+    You should never delete the clipboard. QApplication will do this
+    when the application terminates.
+*/
+QClipboard::~QClipboard()
+{
+}
+#endif
+
+/*!
+    \fn void QClipboard::dataChanged()
+
+    This signal is emitted when the clipboard data is changed.
+*/
+
+/*!
+    \fn void QClipboard::selectionChanged()
+
+    This signal is emitted when the selection is changed. This only
+    applies to windowing systems that support selections, e.g. X11.
+    Windows doesn't support selections.
+*/
+
+/*! \enum QClipboard::Mode
+    \keyword clipboard mode
+
+    This enum type is used to control which part of the system clipboard is
+    used by QClipboard::data(), QClipboard::setData() and related functions.
+
+    \value Clipboard  indicates that data should be stored and retrieved from
+    the global clipboard.
+
+    \value Selection  indicates that data should be stored and retrieved from
+    the global mouse selection.
+
+    \e Note: Support for \c Selection is provided only on systems with a
+    global mouse selection (e.g. X11).
+
+    \sa QClipboard::supportsSelection()
+*/
+
+
+/*****************************************************************************
+  QApplication member functions related to QClipboard.
+ *****************************************************************************/
+
+#ifndef QT_NO_MIMECLIPBOARD
+// text handling is done directly in qclipboard_qws, for now
+
+/*!
+    \overload
+
+    Returns the clipboard text in subtype \a subtype, or a null string
+    if the clipboard does not contain any text. If \a subtype is null,
+    any subtype is acceptable, and \a subtype is set to the chosen
+    subtype.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    text is retrieved from the global clipboard.  If \a mode is
+    QClipboard::Selection, the text is retrieved from the global
+    mouse selection.
+
+    Common values for \a subtype are "plain" and "html".
+
+    \sa setText(), data(), QString::operator!()
+*/
+QString QClipboard::text( QCString &subtype, Mode mode ) const
+{
+    QString r;
+    QTextDrag::decode( data( mode ) ,r, subtype );
+    return r;
+}
+
+/*!
+    \overload
+
+    Returns the clipboard text in subtype \a subtype, or a null string
+    if the clipboard does not contain any text. This function uses the
+    QClipboard::text() function which takes a QClipboard::Mode
+    argument.  The value of the mode argument is determined by the
+    return value of selectionModeEnabled(). If selectionModeEnabled()
+    returns TRUE, the mode argument is QClipboard::Selection,
+    otherwise the mode argument is QClipboard::Clipboard.
+*/
+// ### remove 4.0
+QString QClipboard::text( QCString& subtype ) const
+{
+    return text( subtype, selectionModeEnabled() ? Selection : Clipboard );
+}
+
+/*!
+    Returns the clipboard text as plain text, or a null string if the
+    clipboard does not contain any text.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    text is retrieved from the global clipboard.  If \a mode is
+    QClipboard::Selection, the text is retrieved from the global
+    mouse selection.
+
+    \sa setText(), data(), QString::operator!()
+*/
+QString QClipboard::text( Mode mode ) const
+{
+    QCString subtype = "plain";
+    return text( subtype, mode );
+}
+
+/*!
+    \overload
+
+    This function uses the QClipboard::text() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is
+    QClipboard::Clipboard.
+*/
+
+QString QClipboard::text() const
+{
+    return text( selectionModeEnabled() ? Selection : Clipboard );
+}
+
+ /*!
+    Copies \a text into the clipboard as plain text.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    text is stored in the global clipboard.  If \a mode is
+    QClipboard::Selection, the text is stored in the global
+    mouse selection.
+
+    \sa text(), setData()
+*/
+
+void QClipboard::setText( const QString &text, Mode mode )
+{
+    setData( new QTextDrag(text), mode );
+}
+
+/*!
+    \overload
+
+    This function uses the QClipboard::setText() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is
+    QClipboard::Clipboard.
+*/
+// ### remove 4.0
+void QClipboard::setText( const QString &text )
+{
+    setText( text, selectionModeEnabled() ? Selection : Clipboard );
+}
+
+/*!
+    Returns the clipboard image, or returns a null image if the
+    clipboard does not contain an image or if it contains an image in
+    an unsupported image format.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    image is retrieved from the global clipboard.  If \a mode is
+    QClipboard::Selection, the image is retrieved from the global
+    mouse selection.
+
+    \sa setImage() pixmap() data(), QImage::isNull()
+*/
+QImage QClipboard::image( Mode mode ) const
+{
+    QImage r;
+    QImageDrag::decode( data( mode ), r );
+    return r;
+}
+
+/*!
+    \overload
+
+    This function uses the QClipboard::image() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is
+    QClipboard::Clipboard.
+*/
+// ### remove 4.0
+QImage QClipboard::image() const
+{
+    return image( selectionModeEnabled() ? Selection : Clipboard );
+}
+
+/*!
+    Copies \a image into the clipboard.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    image is stored in the global clipboard.  If \a mode is
+    QClipboard::Selection, the data is stored in the global
+    mouse selection.
+
+    This is shorthand for:
+    \code
+        setData( new QImageDrag(image), mode )
+    \endcode
+
+    \sa image(), setPixmap() setData()
+*/
+void QClipboard::setImage( const QImage &image, Mode mode )
+{
+    setData( new QImageDrag( image ), mode );
+}
+
+/*!
+    \overload
+
+    This function uses the QClipboard::setImage() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is
+    QClipboard::Clipboard.
+*/
+// ### remove 4.0
+void QClipboard::setImage( const QImage &image )
+{
+    setImage( image, selectionModeEnabled() ? Selection : Clipboard );
+}
+
+/*!
+    Returns the clipboard pixmap, or null if the clipboard does not
+    contain a pixmap. Note that this can lose information. For
+    example, if the image is 24-bit and the display is 8-bit, the
+    result is converted to 8 bits, and if the image has an alpha
+    channel, the result just has a mask.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    pixmap is retrieved from the global clipboard.  If \a mode is
+    QClipboard::Selection, the pixmap is retrieved from the global
+    mouse selection.
+
+    \sa setPixmap() image() data() QPixmap::convertFromImage().
+*/
+QPixmap QClipboard::pixmap( Mode mode ) const
+{
+    QPixmap r;
+    QImageDrag::decode( data( mode ), r );
+    return r;
+}
+
+/*!
+    \overload
+
+    This function uses the QClipboard::pixmap() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is
+    QClipboard::Clipboard.
+*/
+// ### remove 4.0
+QPixmap QClipboard::pixmap() const
+{
+    return pixmap( selectionModeEnabled() ? Selection : Clipboard );
+}
+
+/*!
+    Copies \a pixmap into the clipboard. Note that this is slower
+    than setImage() because it needs to convert the QPixmap to a
+    QImage first.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    pixmap is stored in the global clipboard.  If \a mode is
+    QClipboard::Selection, the pixmap is stored in the global
+    mouse selection.
+
+    \sa pixmap() setImage() setData()
+*/
+void QClipboard::setPixmap( const QPixmap &pixmap, Mode mode )
+{
+    // *could* just use the handle, but that is X hackery, MIME is better.
+    setData( new QImageDrag( pixmap.convertToImage() ), mode );
+}
+
+/*!
+    \overload
+
+    This function uses the QClipboard::setPixmap() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is
+    QClipboard::Clipboard.
+*/
+// ### remove 4.0
+void QClipboard::setPixmap( const QPixmap &pixmap )
+{
+    setPixmap( pixmap, selectionModeEnabled() ? Selection : Clipboard );
+}
+
+
+/*! \fn QMimeSource *QClipboard::data( Mode mode ) const
+    Returns a reference to a QMimeSource representation of the current
+    clipboard data.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    data is retrieved from the global clipboard.  If \a mode is
+    QClipboard::Selection, the data is retrieved from the global
+    mouse selection.
+
+    \sa setData()
+*/
+
+/*!
+    \overload
+
+    This function uses the QClipboard::data() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is
+    QClipboard::Clipboard.
+*/
+// ### remove 4.0
+QMimeSource *QClipboard::data() const
+{
+    return data( selectionModeEnabled() ? Selection : Clipboard );
+}
+
+/*! \fn void QClipboard::setData( QMimeSource *src, Mode mode )
+    Sets the clipboard data to \a src. Ownership of the data is
+    transferred to the clipboard. If you want to remove the data
+    either call clear() or call setData() again with new data.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, the
+    data is retrieved from the global clipboard.  If \a mode is
+    QClipboard::Selection, the data is retrieved from the global
+    mouse selection.
+
+    The QDragObject subclasses are reasonable objects to put into the
+    clipboard (but do not try to call QDragObject::drag() on the same
+    object). Any QDragObject placed in the clipboard should have a
+    parent of 0. Do not put QDragMoveEvent or QDropEvent subclasses in
+    the clipboard, as they do not belong to the event handler which
+    receives them.
+
+    The setText(), setImage() and setPixmap() functions are simpler
+    wrappers for setting text, image and pixmap data respectively.
+
+    \sa data()
+*/
+
+/*!
+    \overload
+
+    This function uses the QClipboard::setData() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is
+    QClipboard::Clipboard.
+*/
+// ### remove 4.0
+void QClipboard::setData( QMimeSource *src )
+{
+    setData( src, selectionModeEnabled() ? Selection : Clipboard );
+}
+
+/*! \fn void QClipboard::clear( Mode mode )
+    Clear the clipboard contents.
+
+    The \a mode argument is used to control which part of the system
+    clipboard is used.  If \a mode is QClipboard::Clipboard, this
+    function clears the the global clipboard contents.  If \a mode is
+    QClipboard::Selection, this function clears the global mouse
+    selection contents.
+
+    \sa QClipboard::Mode, supportsSelection()
+*/
+
+/*!
+    \overload
+
+    This function uses the QClipboard::clear() function which takes
+    a QClipboard::Mode argument.  The value of the mode argument is
+    determined by the return value of selectionModeEnabled().
+    If selectionModeEnabled() returns TRUE, the mode argument is
+    QClipboard::Selection, otherwise the mode argument is QClipboard::Clipboard.
+*/
+// ### remove 4.0
+void QClipboard::clear()
+{
+    clear( selectionModeEnabled() ? Selection : Clipboard );
+}
+
+#endif // QT_NO_MIMECLIPBOARD
+#endif // QT_NO_CLIPBOARD