kpushbutton.h

Go to the documentation of this file.

/* 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 <QtGui/QPushButton>

#include <kstandardguiitem.h>

class QDrag;
class QMenu;
class KIcon;

namespace KAuth {
    class Action;
}

class KDEUI_EXPORT KPushButton : public QPushButton
{
    Q_OBJECT
    Q_PROPERTY(bool isDragEnabled READ isDragEnabled WRITE setDragEnabled)

public:

    explicit KPushButton( QWidget *parent = 0 );

    explicit KPushButton( const QString &text, QWidget *parent = 0 );

    KPushButton( const KIcon &icon, const QString &text, QWidget *parent = 0 );

    explicit KPushButton( const KGuiItem &item, QWidget *parent = 0 );

    ~KPushButton();

    void setDragEnabled( bool enable );

    bool isDragEnabled() const;

    void setGuiItem( const KGuiItem& item );

    void setGuiItem( KStandardGuiItem::StandardItem item );

    KStandardGuiItem::StandardItem guiItem() const;

    void setIcon( const KIcon &icon );

#ifndef KDE_NO_DEPRECATED
    KDE_DEPRECATED void setIcon( const QIcon &pix );
#endif

    void setText( const QString &text );

     void setDelayedMenu(QMenu *delayed_menu);

     QMenu *delayedMenu();

    virtual QSize sizeHint() const;

     KAuth::Action *authAction() const;

     void setAuthAction(KAuth::Action *action);

     void setAuthAction(const QString &actionName);

protected:
    virtual QDrag * dragObject();

    virtual void mousePressEvent( QMouseEvent * );
    virtual void mouseMoveEvent( QMouseEvent * );

    virtual void paintEvent( QPaintEvent * );

    virtual void startDrag();

Q_SIGNALS:
    void authorized(KAuth::Action *action);

private:
    void init( const KGuiItem &item );

private:
    class KPushButtonPrivate;
    KPushButtonPrivate * const d;

    Q_PRIVATE_SLOT(d, void slotSettingsChanged( int ))
    Q_PRIVATE_SLOT(d, void slotPressedInternal())
    Q_PRIVATE_SLOT(d, void slotClickedInternal())
    Q_PRIVATE_SLOT(d, void slotDelayedMenuTimeout())
    Q_PRIVATE_SLOT(d, void authStatusChanged(int))
};

#endif // KPUSHBUTTON_H