SARibbonBar.h

#ifndef SARIBBONBAR_H
#define SARIBBONBAR_H
#include "SARibbonCategory.h"
#include "SARibbonContextCategory.h"
#include "SARibbonGlobal.h"
#include <QMenuBar>
#include <QScopedPointer>
#include <QVariant>
 
class QAction;
class QAbstractButton;
class SARibbonElementFactory;
class SARibbonTabBar;
class SARibbonButtonGroupWidget;
class SARibbonQuickAccessBar;
class SARibbonStackedWidget;
class SARibbonTitleIconWidget;
 
class SA_RIBBON_EXPORT SARibbonBar : public QMenuBar
{
    Q_OBJECT
    SA_RIBBON_DECLARE_PRIVATE(SARibbonBar)
    friend class SARibbonMainWindow;
    friend class SARibbonSystemButtonBar;
    Q_PROPERTY(RibbonStyles ribbonStyle READ currentRibbonStyle WRITE setRibbonStyle)
    Q_PROPERTY(bool minimumMode READ isMinimumMode WRITE setMinimumMode)
    Q_PROPERTY(bool minimumModeButton READ haveShowMinimumModeButton WRITE showMinimumModeButton)
    Q_PROPERTY(QColor windowTitleTextColor READ windowTitleTextColor WRITE setWindowTitleTextColor)
    Q_PROPERTY(QColor tabBarBaseLineColor READ tabBarBaseLineColor WRITE setTabBarBaseLineColor)
    Q_PROPERTY(Qt::Alignment windowTitleAligment READ windowTitleAligment WRITE setWindowTitleAligment)
    Q_PROPERTY(bool enableWordWrap READ isEnableWordWrap WRITE setEnableWordWrap)
    Q_PROPERTY(bool enableShowPanelTitle READ isEnableShowPanelTitle WRITE setEnableShowPanelTitle)
    Q_PROPERTY(bool enableIconRightText READ isEnableIconRightText WRITE setEnableIconRightText)
    Q_PROPERTY(bool tabOnTitle READ isTabOnTitle WRITE setTabOnTitle)
    Q_PROPERTY(SARibbonPanel::PanelLayoutMode panelLayoutMode READ panelLayoutMode WRITE setPanelLayoutMode)
 
public:
enum RibbonStyleFlag
    {
        RibbonStyleLoose       = 0x0001,  // bit:0000 0001
        RibbonStyleCompact     = 0x0002,  // bit:0000 0010
        RibbonStyleThreeRow    = 0x0010,  // bit:0001 0000
        RibbonStyleTwoRow      = 0x0020,  // bit:0010 0000
        RibbonStyleSingleRow   = 0x0040,  // bit:0100 0000
 
        RibbonStyleLooseThreeRow   = RibbonStyleLoose | RibbonStyleThreeRow,    
        RibbonStyleCompactThreeRow = RibbonStyleCompact | RibbonStyleThreeRow,  
        RibbonStyleLooseTwoRow     = RibbonStyleLoose | RibbonStyleTwoRow,      
        RibbonStyleCompactTwoRow   = RibbonStyleCompact | RibbonStyleTwoRow,    
        RibbonStyleLooseSingleRow   = RibbonStyleLoose | RibbonStyleSingleRow,  
        RibbonStyleCompactSingleRow = RibbonStyleCompact | RibbonStyleSingleRow 
    };
    Q_ENUM(RibbonStyleFlag)
    Q_DECLARE_FLAGS(RibbonStyles, RibbonStyleFlag)
    Q_FLAG(RibbonStyles)
 
    
    enum RibbonMode
    {
        MinimumRibbonMode,  
        NormalRibbonMode    
    };
    Q_ENUM(RibbonMode)
public:
    using FpCategoryIterate = std::function< bool(SARibbonCategory*) >;
    using FpPanelIterate    = SARibbonCategory::FpPanelIterate;
    using FpContextCategoryHighlight = std::function< QColor(const QColor&) >;
 
public:
    static bool isTwoRowStyle(RibbonStyles s);
    static bool isThreeRowStyle(RibbonStyles s);
    static bool isLooseStyle(RibbonStyles s);
    static bool isCompactStyle(RibbonStyles s);
    static bool isSingleRowStyle(RibbonStyles s);
    static QString versionString();
 
    static QList< QColor > defaultContextCategoryColorList();
 
    static void initHighDpi();
 
public:
    explicit SARibbonBar(QWidget* parent = nullptr);
    ~SARibbonBar();
    QAbstractButton* applicationButton();
 
    void setApplicationButton(QAbstractButton* btn);
 
    SARibbonTabBar* ribbonTabBar();
 
    SARibbonCategory* addCategoryPage(const QString& title);
    void addCategoryPage(SARibbonCategory* category);
 
    Q_INVOKABLE void addCategoryPage(QWidget* category);
 
    SARibbonCategory* insertCategoryPage(const QString& title, int index);
    void insertCategoryPage(SARibbonCategory* category, int index);
 
    SARibbonCategory* categoryByName(const QString& title) const;
 
    SARibbonCategory* categoryByObjectName(const QString& objname) const;
 
    SARibbonCategory* categoryByIndex(int index) const;
 
    void hideCategory(SARibbonCategory* category);
 
    void showCategory(SARibbonCategory* category);
 
    // Batch set categories visible or hidden, only triggers one relayout at the end
    void setCategoriesVisible(const QList< SARibbonCategory* >& categories, bool visible);
 
    bool isCategoryVisible(const SARibbonCategory* c) const;
 
    int categoryIndex(const SARibbonCategory* c) const;
 
    void moveCategory(int from, int to);
 
    QList< SARibbonCategory* > categoryPages(bool getAll = true) const;
 
    void removeCategory(SARibbonCategory* category);
 
    SARibbonContextCategory*
    addContextCategory(const QString& title, const QColor& color = QColor(), const QVariant& id = QVariant());
    void addContextCategory(SARibbonContextCategory* context);
 
    void showContextCategory(SARibbonContextCategory* context);
 
    void hideContextCategory(SARibbonContextCategory* context);
 
    bool isContextCategoryVisible(SARibbonContextCategory* context);
 
    void setContextCategoryVisible(SARibbonContextCategory* context, bool visible);
 
    QList< SARibbonContextCategory* > contextCategoryList() const;
 
    void destroyContextCategory(SARibbonContextCategory* context);
 
    QList< int > currentVisibleContextCategoryTabIndexs() const;
 
    void setMinimumMode(bool isHide);
 
    bool isMinimumMode() const;
 
    void showMinimumModeButton(bool isShow = true);
 
    bool haveShowMinimumModeButton() const;
 
    QAction* minimumModeAction() const;
 
    bool isEnableTabDoubleClickToMinimumMode() const;
    void setTabDoubleClickToMinimumMode(bool on = true) const;
 
    RibbonMode currentRibbonState() const;
 
    int tabBarHeight() const;
    void setTabBarHeight(int h, bool resizeByNow = true);
 
    int titleBarHeight() const;
    void setTitleBarHeight(int h, bool resizeByNow = true);
 
    int categoryHeight() const;
    void setCategoryHeight(int h, bool resizeByNow = true);
 
    int normalModeMainBarHeight() const;
 
    int minimumModeMainBarHeight() const;
 
    SARibbonButtonGroupWidget* activeRightButtonGroup();
 
    SARibbonButtonGroupWidget* rightButtonGroup();
 
    SARibbonQuickAccessBar* activeQuickAccessBar();
 
    SARibbonQuickAccessBar* quickAccessBar();
 
    SARibbonTitleIconWidget* titleIconWidget() const;
 
    void setTitleIconVisible(bool on = true);
    bool isTitleIconVisible() const;
 
    void setRibbonStyle(RibbonStyles v);
    RibbonStyles currentRibbonStyle() const;
 
    void setCurrentIndex(int index);
 
    int currentIndex();
 
    void raiseCategory(SARibbonCategory* category);
 
    bool isTwoRowStyle() const;
    bool isThreeRowStyle() const;
 
    bool isLooseStyle() const;
    bool isCompactStyle() const;
    bool isSingleRowStyle() const;
 
    void updateRibbonGeometry();
 
    SARibbonPanel::PanelLayoutMode panelLayoutMode() const;
    void setPanelLayoutMode(SARibbonPanel::PanelLayoutMode m);
 
    void setTabOnTitle(bool on);
    bool isTabOnTitle() const;
 
    void setTabBarBaseLineColor(const QColor& clr);
    QColor tabBarBaseLineColor() const;
 
    void setWindowTitleTextColor(const QColor& clr);
    QColor windowTitleTextColor() const;
 
    void setTitleVisible(bool on = false);
    bool isTitleVisible() const;
 
    void setWindowTitleBackgroundBrush(const QBrush& bk);
    QBrush windowTitleBackgroundBrush() const;
 
    void setWindowTitleAligment(Qt::Alignment al);
    Qt::Alignment windowTitleAligment() const;
 
    void setEnableWordWrap(bool on);
    bool isEnableWordWrap() const;
 
    void setEnableIconRightText(bool on);
    bool isEnableIconRightText() const;
 
    void setButtonMaximumAspectRatio(qreal fac = 1.4);
    qreal buttonMaximumAspectRatio() const;
 
    void setPanelTitleHeight(int h);
    int panelTitleHeight() const;
 
    void setEnableShowPanelTitle(bool on);
    bool isEnableShowPanelTitle() const;
 
    void setPanelSpacing(int n);
    int panelSpacing() const;
 
    void setPanelToolButtonIconSize(const QSize& smallSize, const QSize& largeSize);
    QPair< QSize, QSize > panelToolButtonIconSize() const;
 
    void setPanelLargeIconSize(const QSize& largeSize);
    QSize panelLargeIconSize() const;
 
    void setPanelSmallIconSize(const QSize& smallSize);
    QSize panelSmallIconSize() const;
 
    SARibbonStackedWidget* ribbonStackedWidget();
 
    void setContextCategoryColorList(const QList< QColor >& cls);
    QList< QColor > contextCategoryColorList() const;
 
    void setContextCategoryTitleTextColor(const QColor& clr);
    QColor contextCategoryTitleTextColor() const;
 
    void setContextCategoryColorHighLight(FpContextCategoryHighlight fp);
 
    void setRibbonAlignment(SARibbonAlignment al);
    SARibbonAlignment ribbonAlignment() const;
 
    bool iterateCategory(FpCategoryIterate fp) const;
    bool iteratePanel(FpPanelIterate fp) const;
 
    void setCornerWidgetVisible(bool on, Qt::Corner c = Qt::TopLeftCorner);
 
    void setApplicationButtonVerticalExpansion(bool on = true);
    bool isApplicationButtonVerticalExpansion() const;
 
    QList< QAction* > allActions() const;
    bool isUseRibbonFrame() const;
Q_SIGNALS:
 
    void applicationButtonClicked();
 
    void currentRibbonTabChanged(int index);
 
    void ribbonModeChanged(SARibbonBar::RibbonMode nowState);
 
    void ribbonStyleChanged(SARibbonBar::RibbonStyles nowStyle);
 
    void titleBarHeightChanged(int oldHeight, int newHeight);
 
    void actionTriggered(QAction* action);
 
protected:
    bool eventFilter(QObject* obj, QEvent* e) override;
    int calcMinTabBarWidth() const;
    void updateCategoryTitleToTabName();
    void setSystemButtonGroupSize(const QSize& s);
    void setMainWindowStyles(SARibbonMainWindowStyles s);
protected Q_SLOTS:
    void onWindowTitleChanged(const QString& title);
    void onWindowIconChanged(const QIcon& i);
    void onCategoryWindowTitleChanged(const QString& title);
    void onStackWidgetHided();
    virtual void onCurrentRibbonTabChanged(int index);
    virtual void onCurrentRibbonTabClicked(int index);
    virtual void onCurrentRibbonTabDoubleClicked(int index);
    void onContextsCategoryPageAdded(SARibbonCategory* category);
    void onContextsCategoryCategoryNameChanged(SARibbonCategory* category, const QString& title);
    void onTabMoved(int from, int to);
 
private:
    int tabIndex(SARibbonCategory* obj);
    void paintInLooseStyle();
    void paintInCompactStyle();
 
    // 刷新所有ContextCategoryManagerData，这个在单独一个Category删除时调用
    void updateContextCategoryManagerData();
    void synchronousCategoryData(bool autoUpdate = true);
    // 把窗口标题文字转换为显示的文字，这里主要针对[*]占位符进行替换
    QString toDisplayTitleText(const QString& title) const;
    // 获取标题显示的区域
    QRect getWindowTitleRect() const;
 
protected:
    void setRibbonMainwindowStyle();
    virtual void paintEvent(QPaintEvent* e) override;
    virtual void moveEvent(QMoveEvent* e) override;
    virtual void changeEvent(QEvent* e) override;
 
    virtual void paintTabbarBaseLine(QPainter& painter);
    virtual void paintWindowTitle(QPainter& painter, const QString& title, const QRect& titleRegion);
    virtual void
    paintContextCategoryTab(QPainter& painter, const QString& title, const QRect& contextRect, const QColor& color);
#if SA_DEBUG_PRINT_SARIBBONBAR
    SA_RIBBON_EXPORT friend QDebug operator<<(QDebug debug, const SARibbonBar& ribbon);
#endif
};
Q_DECLARE_OPERATORS_FOR_FLAGS(SARibbonBar::RibbonStyles)
 
#endif  // SARIBBONBAR_H