SARibbonGallery.h

#ifndef SARIBBONGALLERY_H
#define SARIBBONGALLERY_H
#include "SARibbonGlobal.h"
#include <QFrame>
#include <QToolButton>
#include <QScrollArea>
#include "SARibbonGalleryGroup.h"
class QLabel;
class QVBoxLayout;
class QSizeGrip;
class QShowEvent;
class QHideEvent;
class SARibbonGalleryViewport;
 
class SA_RIBBON_EXPORT SARibbonGalleryButton : public QToolButton
{
    Q_OBJECT
public:
    explicit SARibbonGalleryButton(QWidget* parent = nullptr);
    ~SARibbonGalleryButton();
};
 
class SA_RIBBON_EXPORT SARibbonGallery : public QFrame
{
    Q_OBJECT
    SA_RIBBON_DECLARE_PRIVATE(SARibbonGallery)
public:
    explicit SARibbonGallery(QWidget* parent = nullptr);
    virtual ~SARibbonGallery();
    SARibbonGalleryGroup* addGalleryGroup();
    void addGalleryGroup(SARibbonGalleryGroup* group);
    SARibbonGalleryGroup* addCategoryActions(const QString& title, QList< QAction* > actions);
    void setCurrentViewGroup(SARibbonGalleryGroup* group);
    SARibbonGalleryGroup* currentViewGroup() const;
    SARibbonGalleryViewport* getPopupViewPort() const;
 
public:
    static void setGalleryButtonMaximumWidth(int w);
    void setSingleRowMode(bool on);
    bool isSingleRowMode() const;
Q_SIGNALS:
    void triggered(QAction* action);
    void hovered(QAction* action);
 
public Q_SLOTS:
    virtual void pageUp();
    virtual void pageDown();
    virtual void showMoreDetail();
protected Q_SLOTS:
    void onItemClicked(const QModelIndex& index);
    virtual void onTriggered(QAction* action);
 
private:
    SARibbonGalleryViewport* ensureGetPopupViewPort();
 
protected:
    void resizeEvent(QResizeEvent* event) override;
    void changeEvent(QEvent* event) override;
};
 
class SARibbonGalleryViewport : public QScrollArea
{
    Q_OBJECT
public:
    explicit SARibbonGalleryViewport(QWidget* parent);
    // 添加窗口不带标题
    void addWidget(QWidget* w);
    // 添加窗口，带标题
    void addWidget(QWidget* w, const QString& title);
    // 通过SARibbonGalleryGroup获取对应的标题，用户可以通过此函数设置QLabel的属性
    QLabel* titleLabel(QWidget* w);
    // 移除窗口
    void removeWidget(QWidget* w);
    // 获取此窗口下所有的SARibbonGalleryGroup
    QList< SARibbonGalleryGroup* > galleryGroupList() const;
    // 获取gallery的高度
    int galleryHeight() const;
    // 根据宽度计算高度推荐值
    int heightHintForWidth(int w) const;
public Q_SLOTS:
    void onTitleChanged(QWidget* w, const QString& title);
 
protected:  // 新增
    bool eventFilter(QObject* o, QEvent* e) override;
    void showEvent(QShowEvent* e) override;
    void hideEvent(QHideEvent* e) override;
    void resizeEvent(QResizeEvent* e) override;
 
private:
    QWidget* m_contentWidget { nullptr };            
    QVBoxLayout* m_layout;                           
    QMap< QWidget*, QLabel* > m_widgetToTitleLabel;  
    QSizeGrip* m_sizeGrip;                           
};
 
#endif  // SARIBBONGALLERY_H