Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 123 insertions, 0 deletions

diff --git a/kdecore/kclipboard.h b/kdecore/kclipboard.h
new file mode 100644
index 000000000..bfd5cf8c4
--- /dev/null
+++ b/kdecore/kclipboard.h
@@ -0,0 +1,123 @@
+/* This file is part of the KDE libraries
+    Copyright (C) 2002 Carsten Pfeiffer <pfeiffer@kde.org>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Library General Public
+    License version 2, as published by the Free Software Foundation.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Library General Public License for more details.
+
+    You should have received a copy of the GNU Library General Public License
+    along with this library; see the file COPYING.LIB.  If not, write to
+    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+    Boston, MA 02110-1301, USA.
+*/
+
+#ifndef KCLIPBOARD_H
+#define KCLIPBOARD_H
+
+#include <qclipboard.h>
+#include <qmime.h>
+#include <qobject.h>
+#include <qstrlist.h>
+#include "kdelibs_export.h"
+
+/**
+ * This class is only for internal use.
+ *
+ * @short Allowing to automatically synchronize the X11 Clipboard and Selection buffers.
+ * @author Carsten Pfeiffer <pfeiffer@kde.org>
+ * @since 3.1
+ * @internal
+ */
+class KDECORE_EXPORT KClipboardSynchronizer : public QObject
+{
+    Q_OBJECT
+
+public:
+    /** Systray widget for manipulating the clipboard. */
+    friend class KlipperWidget;
+    friend class KApplication;
+
+    /**
+     * Returns the KClipboardSynchronizer singleton object.
+     * @return the KClipboardSynchronizer singleton object.
+     */
+    static KClipboardSynchronizer *self();
+
+    /**
+     * Configures KClipboardSynchronizer to synchronize the Selection to Clipboard whenever
+     * it changes.
+     *
+     * Default is false.
+     * @see isSynchronizing
+     */
+    static void setSynchronizing( bool sync );
+
+    /**
+     * Checks whether Clipboard and Selection will be synchronized upon changes.
+     * @returns whether Clipboard and Selection will be synchronized upon
+     * changes.
+     * @see setSynchronizing
+     */
+    static bool isSynchronizing()
+    {
+        return s_sync;
+    }
+
+    /**
+     * Configures KClipboardSynchronizer to copy the Clipboard buffer to the Selection
+     * buffer whenever the Clipboard changes.
+     *
+     *
+     * @param enable true to enable implicit selection, false otherwise.
+     * Default is true.
+     * @see selectionSetting
+     */
+    static void setReverseSynchronizing( bool enable );
+
+    /**
+     * Checks whether the  Clipboard buffer will be copied to the Selection
+     * buffer upon changes.
+     * @returns whether the Clipboard buffer will be copied to the Selection
+     * buffer upon changes.
+     * @see setSelectionSetting
+     */
+    static bool isReverseSynchronizing()
+    {
+        return s_reverse_sync;
+    }
+
+
+protected:
+    ~KClipboardSynchronizer();
+
+private slots:
+    void slotSelectionChanged();
+    void slotClipboardChanged();
+
+private:
+    KClipboardSynchronizer( QObject *parent = 0, const char *name = 0L );
+    void setupSignals();
+
+    static void setClipboard( QMimeSource* data, QClipboard::Mode mode );
+
+    static KClipboardSynchronizer *s_self;
+    static bool s_sync;
+    static bool s_reverse_sync;
+    static bool s_blocked;
+
+    class MimeSource;
+
+private:
+    // needed by klipper
+    enum Configuration { Synchronize = 1 };
+    // called by KApplication upon kipc message, invoked by klipper
+    static void newConfiguration( int config );
+
+};
+
+#endif // KCLIPBOARD_H