ribbonactionsmanager.h

浏览该文件的文档.

 
#pragma once
 
#include "qxribbon_global.h"
 
#include <QAbstractListModel>
#include <QAction>
#include <QMap>
#include <QObject>
#include <QSet>
#include <QString>
 
QX_RIBBON_BEGIN_NAMESPACE
 
class RibbonBar;
class RibbonPage;
class RibbonActionsManagerPrivate;
 
class QX_RIBBON_EXPORT RibbonActionsManager : public QObject
{
    Q_OBJECT
public:
    enum ActionTag {
        UnknowActionTag = 0,                    
        CommonlyUsedActionTag = 0x01,           
        NotInFunctionalAreaActionTag = 0x02,    
        AutoPageDistinguishBeginTag = 0x1000,   
        AutoPageDistinguishEndTag = 0x2000,     
        NotInRibbonPageTag = 0x2001,            
        UserDefineActionTag = 0x8000,           
    };
public:
    RibbonActionsManager(RibbonBar *bar);
    ~RibbonActionsManager();
 
    // 设置tag对应的名字
    void setTagName(int tag, const QString &name);
 
    // 获取tag对应的名字
    QString tagName(int tag) const;
 
    // 移除tag，注意，这个函数非常耗时
    void removeTag(int tag);
 
    // 注册action
    bool registerAction(QAction *act, int tag, const QString &key = QString(), bool enableEmit = true);
 
    // 取消action的注册
    void unregisterAction(QAction *act, bool enableEmit = true);
 
    // 通过tag筛选出系列action
    QList<QAction *> actions(int tag) const;
 
    // 获取所有的标签
    QList<int> actionTags() const;
 
    // 通过key获取action
    QAction *action(const QString &key) const;
 
    // 通过action找到key
    QString key(QAction *act) const;
 
    // 返回所有管理的action数
    int count() const;
 
    // 返回所有管理的actions
    QList<QAction *> allActions() const;
 
    // 自动加载RibbonBar下的actions
    QMap<int, RibbonPage *> autoRegisterActions(RibbonBar *bar);
 
    // 自动加载widget下的actions
    QSet<QAction *> autoRegisterWidgetActions(QWidget *w, int tag, bool enableEmit = false);
 
    // 根据标题查找action
    QList<QAction *> search(const QString &text);
 
    // 清除
    void clear();
 
    // 获取ribbonbar
    RibbonBar *ribbonBar() const;
 
    // 设置所有管理的action都可以编辑
    void setAllActionCanCustomize(bool on = true);
 
Q_SIGNALS:
    void actionTagChanged(int tag, bool isDeleted);
 
private Q_SLOTS:
    void onActionDestroyed(QObject *o);
    void onPageTitleChanged(const QString &title);
private:
    void removeAction(QAction *act, bool enableEmit = true);
private:
    QX_DECLARE_PRIVATE(RibbonActionsManager)
    friend class RibbonActionsManagerModel;
};
 
QX_RIBBON_END_NAMESPACE