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, 159 insertions, 0 deletions

diff --git a/kdeui/kdualcolorbutton.h b/kdeui/kdualcolorbutton.h
new file mode 100644
index 000000000..eb4a71ab2
--- /dev/null
+++ b/kdeui/kdualcolorbutton.h
@@ -0,0 +1,159 @@
+/* This file is part of the KDE libraries
+   Copyright (C) 1999 Daniel M. Duley <mosfet@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 __KDUALCOLORBTN_H
+#define __KDUALCOLORBTN_H
+
+class QBitmap;
+#include <qbrush.h>
+#include <qwidget.h>
+
+#include <kdelibs_export.h>
+
+/**
+ * @short A widget for selecting two related colors.
+ *
+ * KDualColorButton allows the user to select two cascaded colors (usually a
+ * foreground and background color). Other features include drag and drop
+ * from other KDE color widgets, a reset to black and white control, and a
+ * swap colors control.
+ *
+ * When the user clicks on the foreground or background rectangle the
+ * rectangle is first sunken and the currentChanged() signal is emitted.
+ * Further clicks will present a color dialog and emit either the fgChanged()
+ * or bgChanged() if a new color is selected.
+ *
+ * Note: With drag and drop when dropping a color the current selected color
+ * will be set, while when dragging a color it will use whatever color
+ * rectangle the mouse was pressed inside.
+ *
+ * \image html kdualcolorbutton.png "KDE Dual Color Button"
+ *
+ * @author Daniel M. Duley <mosfet@kde.org>
+ */
+class KDEUI_EXPORT KDualColorButton : public QWidget
+{
+    Q_OBJECT
+    Q_ENUMS( DualColor )
+    Q_PROPERTY( QColor foreground READ foreground WRITE setForeground )
+    Q_PROPERTY( QColor background READ background WRITE setBackground )
+    Q_PROPERTY( QColor currentColor READ currentColor WRITE setCurrentColor STORED false DESIGNABLE false )
+    Q_PROPERTY( DualColor current READ current WRITE setCurrent )
+
+public:
+
+    enum DualColor { Foreground, Background };
+    /**
+     * Constructs a new KDualColorButton using the default black and white
+     * colors.
+     *
+     * As of KDE 3.5.1, sets the dialog parent to the same as "parent" if that
+     * argument is non-null and the dialogParent argument is null.
+     */
+    KDualColorButton(QWidget *parent=0, const char *name=0, QWidget* dialogParent=0);
+
+    /**
+     * Constructs a new KDualColorButton with the supplied foreground and
+     * background colors.
+     */
+    KDualColorButton(const QColor &fgColor, const QColor &bgColor,
+                     QWidget *parent=0, const char *name=0, QWidget* dialogParent=0);
+
+    ~KDualColorButton();
+    /**
+     * Returns the current foreground color.
+     */
+    QColor foreground() const;
+    /**
+     * Returns the current background color.
+     */
+    QColor background() const;
+    /**
+     * Returns the current color item selected by the user.
+     */
+    DualColor current() const;
+    /**
+     * Returns the color of the selected item.
+     */
+    QColor currentColor() const;
+    /**
+     * Returns the minimum size needed to display the widget and all its
+     * controls.
+     */
+    virtual QSize sizeHint() const;
+public slots:
+    /**
+     * Sets the foreground color.
+     */
+    void setForeground(const QColor &c);
+    /**
+     * Sets the background color.
+     */
+    void setBackground(const QColor &c);
+    /**
+     * Sets the current selected color item.
+     */
+    void setCurrent(DualColor s);
+    /**
+     * Sets the color of the selected item.
+     */
+    void setCurrentColor(const QColor &c);
+signals:
+    /**
+     * Emitted when the foreground color is changed.
+     */
+    void fgChanged(const QColor &c);
+    /**
+     * Emitted when the background color is changed.
+     */
+    void bgChanged(const QColor &c);
+    /**
+     * Emitted when the user changes the current color selection.
+     */
+    void currentChanged(KDualColorButton::DualColor s);
+protected:
+    /**
+     * Sets the supplied rectangles to the proper size and position for the
+     * current widget size. You can reimplement this to change the layout
+     * of the widget. Restrictions are that the swap control will always
+     * be at the top right, the reset control will always be at the bottom
+     * left, and you must leave at least a 14x14 space in those corners.
+     */
+    virtual void metrics(QRect &fgRect, QRect &bgRect);
+    virtual void paintEvent(QPaintEvent *ev);
+    virtual void mousePressEvent(QMouseEvent *ev);
+    virtual void mouseMoveEvent(QMouseEvent *ev);
+    virtual void mouseReleaseEvent(QMouseEvent *ev);
+    // Dnd
+    virtual void dragEnterEvent(QDragEnterEvent *ev);
+    virtual void dropEvent(QDropEvent *ev);
+private:
+    QBitmap *arrowBitmap;
+    QPixmap *resetPixmap;
+    QBrush fg, bg;
+    QPoint mPos;
+    bool dragFlag, miniCtlFlag;
+    DualColor curColor, tmpColor;
+
+protected:
+    virtual void virtual_hook( int id, void* data );
+private:
+    class KDualColorPrivate;
+    KDualColorPrivate *d;
+};
+
+#endif