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

diff --git a/kdeui/kpushbutton.h b/kdeui/kpushbutton.h
new file mode 100644
index 000000000..637cfceb3
--- /dev/null
+++ b/kdeui/kpushbutton.h
@@ -0,0 +1,161 @@
+/* This file is part of the KDE libraries
+    Copyright (C) 2000 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 as published by the Free Software Foundation; either
+    version 2 of the License, or (at your option) any later version.
+
+    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 KPUSHBUTTON_H
+#define KPUSHBUTTON_H
+
+#include <qpoint.h>
+#include <qpushbutton.h>
+#include <kguiitem.h>
+#include <kstdguiitem.h> 
+
+class QDragObject;
+/**
+ * This is nothing but a QPushButton with drag-support and KGuiItem support. You have to call
+ * setDragEnabled( true ) and override the virtual method
+ * dragObject() to specify the QDragObject to be used.
+ *
+ * @short A QPushButton with drag-support and KGuiItem support
+ * @author Carsten Pfeiffer <pfeiffer@kde.org>
+ */
+class KDEUI_EXPORT KPushButton : public QPushButton
+{
+    Q_OBJECT
+    Q_PROPERTY(int stdItem READ guiItm WRITE setGuiItm )
+    Q_PROPERTY(bool isDragEnabled READ isDragEnabled WRITE setDragEnabled)
+
+public:
+
+    /**
+     * Default constructor.
+     */
+    KPushButton( QWidget *parent, const char *name=0 );
+
+    /**
+     * Constructor, that sets the button-text to @p text
+     */
+    KPushButton( const QString &text, QWidget *parent, const char *name=0);
+
+    /**
+     * Constructor, that sets an icon and the button-text to @p text
+     */
+    KPushButton( const QIconSet &icon, const QString &text,
+		     QWidget *parent, const char *name=0 );
+
+    /**
+     * Constructor that takes a KGuiItem for the text, the icon, the tooltip
+     * and the what's this help
+     */
+    KPushButton( const KGuiItem &item, QWidget *parent, const char *name = 0 );
+
+    /**
+     * Destructs the button.
+     */
+    ~KPushButton();
+
+    /**
+     * Enables/disables drag-support. Default is disabled.
+     */
+    void setDragEnabled( bool enable );
+
+    /**
+     * @returns if drag support is enabled or not.
+     */
+    bool isDragEnabled() const { return m_dragEnabled; }
+
+    /**
+     * Sets the KGuiItem for this button.
+     */
+    void setGuiItem( const KGuiItem& item );
+
+    /** 
+    * Sets the standard KGuiItem for this button.
+    * @since 3.4
+    */
+    void setGuiItem( KStdGuiItem::StdItem item );
+
+    /**
+    * Reads the standard KGuiItem for this button. 
+    * @since 3.4
+    */
+    KStdGuiItem::StdItem guiItem() const;
+
+    // Hack for Qt designer
+    void setGuiItm(int itm ) { setGuiItem( (KStdGuiItem::StdItem)itm );}
+    int guiItm() const { return (int)guiItem(); }
+
+    /**
+     * Sets the Icon Set for this button. It also takes into account hte
+     * KGlobalSettings::showIconsOnPushButtons() setting.
+     */
+    void setIconSet( const QIconSet &iconSet );
+
+    /**
+    * Sets the text of the button
+    */
+    void setText( const QString &text );
+
+protected:
+    /**
+     * Reimplement this and return the QDragObject that should be used
+     * for the drag.
+     * Default implementation returns 0L, so that no drag is initiated.
+     */
+    virtual QDragObject * dragObject();
+
+    /**
+     * Reimplemented to add drag-support
+     */
+    virtual void mousePressEvent( QMouseEvent * );
+    /**
+     * Reimplemented to add drag-support
+     */
+    virtual void mouseMoveEvent( QMouseEvent * );
+
+    /**
+     * Starts a drag (dragCopy() by default) using dragObject()
+     */
+    virtual void startDrag();
+
+private:
+    bool m_dragEnabled;
+    QPoint startPos;
+
+private slots:
+    void slotSettingsChanged( int category );
+
+private:
+    /**
+     * Internal.
+     * Initialize the KPushButton instance
+     */
+    void init( const KGuiItem &item );
+
+    void readSettings();
+    static bool s_useIcons;
+
+protected:
+    virtual void virtual_hook( int id, void* data );
+private:
+    class KPushButtonPrivate;
+    KPushButtonPrivate *d;
+
+};
+
+#endif // KPUSHBUTTON_H