ribbongroup.h

浏览该文件的文档.

 
#pragma once
 
#include "qxribbon_global.h"
#include "ribbonbutton.h"
 
#include <QWidget>
 
QX_RIBBON_BEGIN_NAMESPACE
 
class RibbonGallery;
class RibbonGroupPrivate;
 
class QX_RIBBON_EXPORT RibbonGroup : public QWidget
{
    Q_OBJECT
    Q_PROPERTY(bool isCanCustomize READ isCanCustomize WRITE setCanCustomize)
    Q_PROPERTY(bool isExpanding READ isExpanding WRITE setExpanding)
    Q_PROPERTY(QString groupName READ groupName WRITE setGroupName)
public:
    enum GroupLayoutMode {
        ThreeRowMode,   
        TwoRowMode      
    };
    enum RowProportion {
        Auto,   
        Large,    
        Medium,   
        Small,    
    };
public:
    // make the addAction of QWidget visible in the subclass
    using QWidget::addAction;
public:
    explicit RibbonGroup(QWidget *parent = Q_NULLPTR);
    explicit RibbonGroup(const QString &name, QWidget *parent = Q_NULLPTR);
    ~RibbonGroup() Q_DECL_OVERRIDE;
 
    QString groupName() const;
    void setGroupName(const QString &title);
    QString title() const;
    void setTitle(const QString &title);
 
    static RibbonGroup::RowProportion getActionRowProportionProperty(QAction *action);
    static void setActionRowProportionProperty(QAction *action, RibbonGroup::RowProportion rp);
 
    void setActionRowProportion(QAction *action, RibbonGroup::RowProportion rp);
 
    RibbonButton *addAction(QAction *action, RibbonGroup::RowProportion rp);
    RibbonButton *addLargeAction(QAction *action);
    RibbonButton *addMediumAction(QAction *action);
    RibbonButton *addSmallAction(QAction *action);
 
    void addAction(QAction *act, QToolButton::ToolButtonPopupMode popMode,
                   RibbonGroup::RowProportion rp = RibbonGroup::Large);
    QAction *addAction(const QString &text, const QIcon &icon, QToolButton::ToolButtonPopupMode popMode,
                       RibbonGroup::RowProportion rp = RibbonGroup::Large);
 
    RibbonButton *addMenu(QMenu *menu, RibbonGroup::RowProportion rp,
                          QToolButton::ToolButtonPopupMode popMode = QToolButton::InstantPopup);
    RibbonButton *addLargeMenu(QMenu *menu, QToolButton::ToolButtonPopupMode popMode = QToolButton::InstantPopup);
    RibbonButton *addSmallMenu(QMenu *menu, QToolButton::ToolButtonPopupMode popMode = QToolButton::InstantPopup);
 
    RibbonButton *addActionMenu(QAction *action, QMenu *menu, RibbonGroup::RowProportion rp);
    RibbonButton *addLargeActionMenu(QAction *action, QMenu *menu);
 
    QAction *addWidget(QWidget *w, RibbonGroup::RowProportion rp);
    QAction *addLargeWidget(QWidget *w);
    QAction *addMediumWidget(QWidget *w);
    QAction *addSmallWidget(QWidget *w);
 
    RibbonGallery *addGallery();
 
    QAction *addSeparator(int top = 6, int bottom = 6);
 
    int ribbonButtonCount() const;
    RibbonButton *ribbonButtonByIndex(int index) const;
    RibbonButton *ribbonButtonForAction(QAction *action) const;
    QList<RibbonButton *> ribbonButtons() const;
 
    bool hasOptionAction() const;
    void addOptionAction(QAction *action);
 
    int actionIndex(QAction *act) const;
    void moveAction(int from, int to);
 
    GroupLayoutMode groupLayoutMode() const;
 
    bool isTwoRow() const;
 
    virtual QSize optionActionButtonSize() const;
    virtual QSize sizeHint() const Q_DECL_OVERRIDE;
    virtual QSize minimumSizeHint() const Q_DECL_OVERRIDE;
 
    bool isExpanding() const;
    void setExpanding(bool expanding = true);
 
    bool isCanCustomize() const;
    void setCanCustomize(bool b);
 
    int largeHeight() const;
    int titleHeight() const;
 
    static bool titleVisible();
    static void setTitleVisible(bool visible);
 
    static int groupTitleHeight();
    static void setGroupTitleHeight(int h);
Q_SIGNALS:
    void actionTriggered(QAction *action);
protected:
    void setGroupLayoutMode(GroupLayoutMode mode);
    void updateItemGeometry();
protected:
    virtual void paintEvent(QPaintEvent *event) Q_DECL_OVERRIDE;
    virtual void resizeEvent(QResizeEvent *event) Q_DECL_OVERRIDE;
    virtual void actionEvent(QActionEvent *event) Q_DECL_OVERRIDE;
private:
    QX_DECLARE_PRIVATE(RibbonGroup)
    friend class RibbonPage;
    friend class RibbonPagePrivate;
    friend class RibbonCustomizeWidgetPrivate;
};
 
QX_RIBBON_END_NAMESPACE