// qaction.sip generated by MetaSIP on Fri Feb 10 10:35:12 2012
//
// This file is part of the QtGui Python extension module.
//
// Copyright (c) 2011 Riverbank Computing Limited <info@riverbankcomputing.com>
// 
// This file is part of PyQt.
// 
// 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 Riverbank
// Computing Limited (or its successors, if any) and the KDE Free Qt
// Foundation. In addition, as a special exception, Riverbank gives you
// certain additional rights. These rights are described in the Riverbank
// GPL Exception version 1.1, which can be found in the file
// GPL_EXCEPTION.txt in this package.
// 
// If you are unsure which license is appropriate for your use, please
// contact the sales department at sales@riverbankcomputing.com.
// 
// This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
// WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.


class QAction : QObject
{
%TypeHeaderCode
#include <qaction.h>
%End

public:
    explicit QAction(QObject *parent /TransferThis/);
    QAction(const QString &text, QObject *parent /TransferThis/);
    QAction(const QIcon &icon, const QString &text, QObject *parent /TransferThis/);
    virtual ~QAction();
    void setActionGroup(QActionGroup *group /KeepReference/);
    QActionGroup *actionGroup() const;
    void setIcon(const QIcon &icon);
    QIcon icon() const;
    void setText(const QString &text);
    QString text() const;
    void setIconText(const QString &text);
    QString iconText() const;
    void setToolTip(const QString &tip);
    QString toolTip() const;
    void setStatusTip(const QString &statusTip);
    QString statusTip() const;
    void setWhatsThis(const QString &what);
    QString whatsThis() const;
    QMenu *menu() const;
    void setMenu(QMenu *menu /KeepReference/);
    void setSeparator(bool b);
    bool isSeparator() const;
    void setShortcut(const QKeySequence &shortcut);
    QKeySequence shortcut() const;
    void setShortcutContext(Qt::ShortcutContext context);
    Qt::ShortcutContext shortcutContext() const;
    void setFont(const QFont &font);
    QFont font() const;
    void setCheckable(bool);
    bool isCheckable() const;
    QVariant data() const;
    void setData(const QVariant &var);
    bool isChecked() const;
    bool isEnabled() const;
    bool isVisible() const;

    enum ActionEvent
    {
        Trigger,
        Hover,
    };

    void activate(QAction::ActionEvent event);
    bool showStatusText(QWidget *widget = 0);
    QWidget *parentWidget() const;

protected:
    virtual bool event(QEvent *);

public slots:
    void trigger();
    void hover();
    void setChecked(bool);
    void toggle();
    void setEnabled(bool);
    void setDisabled(bool b);
    void setVisible(bool);

signals:
    void changed();
    void triggered(bool checked = false);
    void hovered();
    void toggled(bool);

public:
%If (Qt_4_2_0 -)

    enum MenuRole
    {
        NoRole,
        TextHeuristicRole,
        ApplicationSpecificRole,
        AboutQtRole,
        AboutRole,
        PreferencesRole,
        QuitRole,
    };

%End
%If (Qt_4_2_0 -)
    void setShortcuts(const QList<QKeySequence> &shortcuts);
%End
%If (Qt_4_2_0 -)
    void setShortcuts(QKeySequence::StandardKey);
%End
%If (Qt_4_2_0 -)
    QList<QKeySequence> shortcuts() const;
%End
%If (Qt_4_2_0 -)
    void setAutoRepeat(bool);
%End
%If (Qt_4_2_0 -)
    bool autoRepeat() const;
%End
%If (Qt_4_2_0 -)
    void setMenuRole(QAction::MenuRole menuRole);
%End
%If (Qt_4_2_0 -)
    QAction::MenuRole menuRole() const;
%End
%If (Qt_4_2_0 -)
    QList<QWidget*> associatedWidgets() const;
%End
%If (Qt_4_5_0 -)
    QList<QGraphicsWidget*> associatedGraphicsWidgets() const;
%End
%If (Qt_4_4_0 -)
    void setIconVisibleInMenu(bool visible);
%End
%If (Qt_4_4_0 -)
    bool isIconVisibleInMenu() const;
%End
%If (Qt_4_6_0 -)

    enum SoftKeyRole
    {
        NoSoftKey,
        PositiveSoftKey,
        NegativeSoftKey,
        SelectSoftKey,
    };

%End
%If (Qt_4_6_0 -)

    enum Priority
    {
        LowPriority,
        NormalPriority,
        HighPriority,
    };

%End
%If (Qt_4_6_0 -)
    void setPriority(QAction::Priority priority);
%End
%If (Qt_4_6_0 -)
    QAction::Priority priority() const;
%End
%If (Qt_4_6_0 -)
    void setSoftKeyRole(QAction::SoftKeyRole softKeyRole);
%End
%If (Qt_4_6_0 -)
    QAction::SoftKeyRole softKeyRole() const;
%End

private:
    QAction(const QAction &);
};
