ribbonbar.h

浏览该文件的文档.

 
#pragma once
 
#include "qxribbon_global.h"
#include "ribbonpage.h"
#include "ribbonpagecontext.h"
 
#include <QMenuBar>
#include <QScopedPointer>
#include <QVariant>
 
class QAbstractButton;
 
QX_RIBBON_BEGIN_NAMESPACE
 
class RibbonFactory;
class RibbonBarPrivate;
class RibbonButtonGroup;
class RibbonQuickAccessBar;
 
class QX_RIBBON_EXPORT RibbonBar : public QMenuBar
{
    Q_OBJECT
    Q_PROPERTY(RibbonStyle ribbonStyle READ currentRibbonStyle WRITE setRibbonStyle)
    Q_PROPERTY(
        QuickAccessBarPosition quickAccessBarPosition READ quickAccessBarPosition WRITE setQuickAccessBarPosition)
    Q_PROPERTY(bool minimized READ isMinimized WRITE setMinimized)
    Q_PROPERTY(bool minimumButton READ haveShowMinimumButton WRITE showMinimumButton)
    Q_PROPERTY(Qt::Alignment windowTitleAligment READ windowTitleAligment WRITE setWindowTitleAligment)
public:
    enum RibbonStyle {
        OfficeStyle = 0x0000,
        WpsLiteStyle = 0x0001,
        OfficeStyleTwoRow = 0x0100 | OfficeStyle,
        WpsLiteStyleTwoRow = 0x0100 | WpsLiteStyle,
    };
    Q_ENUM(RibbonStyle)
 
    enum QuickAccessBarPosition {
        // Only for WpsLiteStyle
        QABLeftPosition = 1,
        QABRightPosition
    };
    Q_ENUM(QuickAccessBarPosition)
 
    enum TabBarPosition {
        TBLeftPosition,
        TBCenterPosition
    };
    Q_ENUM(TabBarPosition)
public:
    RibbonBar(QWidget *parent = Q_NULLPTR);
    ~RibbonBar() Q_DECL_OVERRIDE;
 
    QAbstractButton *applicationButton();
    void setApplicationButton(QAbstractButton *btn);
 
    RibbonPage *addPage(const QString &title);
    void addPage(RibbonPage *page);
    RibbonPage *insertPage(int index, const QString &title);
    void insertPage(int index, RibbonPage *page);
 
    RibbonPage *page(int index) const;
    RibbonPage *pageByName(const QString &title) const;
    RibbonPage *pageByObjectName(const QString &objname) const;
    QList<RibbonPage *> pages(bool getAll = true) const;
 
    bool isPageVisible(RibbonPage *page) const;
    void showPage(RibbonPage *page);
    void hidePage(RibbonPage *page);
    void raisePage(RibbonPage *page);
 
    void removePage(RibbonPage *page);
    void clearPages();
    void movePage(int from, int to);
 
    int pageIndex(RibbonPage *page) const;
 
    RibbonPageContext *addPageContext(const QString &title, const QColor &color = QColor());
    void addPageContext(RibbonPageContext *context);
 
    void showPageContext(RibbonPageContext *context);
    void hidePageContext(RibbonPageContext *context);
 
    bool isPageContextVisible(RibbonPageContext *context);
    void setPageContextVisible(RibbonPageContext *context, bool visible);
 
    bool isPageContextCoverTab();
    void setPageContextCoverTab(bool cover);
 
    QList<RibbonPageContext *> pageContextList() const;
 
    void destroyPageContext(RibbonPageContext *context);
 
    void minimize();
    bool isMinimized() const;
    void setMinimized(bool flag);
 
    bool haveShowMinimumButton() const;
    void showMinimumButton(bool isShow = true);
 
    int tabBarHeight() const;
    int titleBarHeight() const;
 
    RibbonButtonGroup *cornerButtonGroup(Qt::Corner corner = Qt::BottomRightCorner);
 
    RibbonQuickAccessBar *quickAccessBar() const;
    void setQuickAccessBarPosition(QuickAccessBarPosition position);
    QuickAccessBarPosition quickAccessBarPosition() const;
 
    void setTabBarPosition(TabBarPosition position);
    TabBarPosition tabBarPosition() const;
 
    RibbonStyle currentRibbonStyle() const;
    void setRibbonStyle(RibbonStyle v);
 
    int currentIndex();
    void setCurrentIndex(int index);
 
    bool isOfficeStyle() const;
    bool isTwoRowStyle() const;
 
    void setWindowButtonGroup(QWidget *widget);
 
    void updateRibbonGeometry();
    void updateRibbonTheme();
    void resizeRibbon();
 
    Qt::Alignment windowTitleAligment() const;
    void setWindowTitleAligment(Qt::Alignment al);
 
    void setWindowTitleVisible(bool visible);
 
    QSize sizeHint() const Q_DECL_OVERRIDE;
    QSize minimumSizeHint() const Q_DECL_OVERRIDE;
 
Q_SIGNALS:
    void minimizationChanged(bool minimized);
    void applicationButtonClicked();
    void currentRibbonTabChanged(int index);
    void ribbonStyleChanged(RibbonStyle nowStyle);
protected:
    bool event(QEvent *event) Q_DECL_OVERRIDE;
    bool eventFilter(QObject *obj, QEvent *e) Q_DECL_OVERRIDE;
    void paintEvent(QPaintEvent *e) Q_DECL_OVERRIDE;
    void resizeEvent(QResizeEvent *e) Q_DECL_OVERRIDE;
private:
    QX_DECLARE_PRIVATE(RibbonBar)
};
 
QX_RIBBON_END_NAMESPACE