SARibbonCategory.h

#ifndef SARIBBONCATEGORY_H
#define SARIBBONCATEGORY_H
#include "SARibbonGlobal.h"
#include <QFrame>
#include "SARibbonPanel.h"
#include <QScopedPointer>
#include <QPushButton>
#include <QWheelEvent>
 
class QAction;
class QHBoxLayout;
class QWheelEvent;
class SARibbonBar;
class SARibbonCategoryLayout;
 
class SA_RIBBON_EXPORT SARibbonCategory : public QFrame
{
    Q_OBJECT
    SA_RIBBON_DECLARE_PRIVATE(SARibbonCategory)
    friend class SARibbonBar;
    friend class SARibbonContextCategory;
    Q_PROPERTY(bool isCanCustomize READ isCanCustomize WRITE setCanCustomize)
    Q_PROPERTY(QString categoryName READ categoryName WRITE setCategoryName)
public:
    using FpPanelIterate = std::function< bool(SARibbonPanel*) >;
 
public:
    explicit SARibbonCategory(QWidget* p = nullptr);
    explicit SARibbonCategory(const QString& name, QWidget* p = nullptr);
    ~SARibbonCategory();
 
    QString categoryName() const;
 
    void setCategoryName(const QString& title);
 
    SARibbonPanel::PanelLayoutMode panelLayoutMode() const;
 
    void setPanelLayoutMode(SARibbonPanel::PanelLayoutMode m);
 
    SARibbonPanel* addPanel(const QString& title);
 
    void addPanel(SARibbonPanel* panel);
 
    Q_INVOKABLE void addPanel(QWidget* panel);
 
    SARibbonPanel* insertPanel(const QString& title, int index);
 
    void insertPanel(SARibbonPanel* panel, int index);
 
    SARibbonPanel* panelByName(const QString& title) const;
 
    SARibbonPanel* panelByObjectName(const QString& objname) const;
 
    SARibbonPanel* panelByIndex(int index) const;
 
    int panelIndex(SARibbonPanel* p) const;
 
    void movePanel(int from, int to);
 
    bool takePanel(SARibbonPanel* panel);
 
    bool removePanel(SARibbonPanel* panel);
 
    bool removePanel(int index);
 
    QList< SARibbonPanel* > panelList() const;
 
    bool isContextCategory() const;
 
    int panelCount() const;
 
    bool isCanCustomize() const;
    void setCanCustomize(bool b);
 
    int panelTitleHeight() const;
    void setPanelTitleHeight(int h);
 
    bool isEnableShowPanelTitle() const;
    void setEnableShowPanelTitle(bool on);
 
    void setCategoryAlignment(SARibbonAlignment al);
    SARibbonAlignment categoryAlignment() const;
 
    void setPanelSpacing(int n);
    int panelSpacing() const;
 
    void setPanelLargeIconSize(const QSize& largeSize);
    QSize panelLargeIconSize() const;
 
    void setPanelSmallIconSize(const QSize& smallSize);
    QSize panelSmallIconSize() const;
 
    void setPanelToolButtonIconSize(const QSize& smallSize, const QSize& largeSize);
    QPair< QSize, QSize > panelToolButtonIconSize() const;
 
    SARibbonBar* ribbonBar() const;
 
    void updateItemGeometry();
 
    void setUseAnimatingScroll(bool useAnimating);
    bool isUseAnimatingScroll() const;
 
    void setWheelScrollStep(int step);
    int wheelScrollStep() const;
 
    void setAnimationDuration(int duration);
    int animationDuration() const;
 
    bool isEnableWordWrap() const;
 
    qreal buttonMaximumAspectRatio() const;
 
    bool iteratePanel(FpPanelIterate fp) const;
 
    QSize sizeHint() const Q_DECL_OVERRIDE;
Q_SIGNALS:
    void categoryNameChanged(const QString& n);
 
    void actionTriggered(QAction* action);
 
protected:
    virtual bool event(QEvent* e) override;
    void wheelEvent(QWheelEvent* event) override;
    void changeEvent(QEvent* event) override;
 
    void markIsContextCategory(bool isContextCategory = true);
 
    SARibbonCategoryLayout* categoryLayout() const;
 
    void setEnableWordWrap(bool on);
 
    void setButtonMaximumAspectRatio(qreal fac = 1.4);
};
 
class SA_RIBBON_EXPORT SARibbonCategoryScrollButton : public QToolButton
{
    Q_OBJECT
public:
    explicit SARibbonCategoryScrollButton(Qt::ArrowType arr, QWidget* p = nullptr);
    ~SARibbonCategoryScrollButton();
};
 
#endif  // SARIBBONCATEGORY_H