SARibbonToolButton.h

#ifndef SARIBBONTOOLBUTTON_H
#define SARIBBONTOOLBUTTON_H
#include "SARibbonGlobal.h"
#include <QToolButton>
#include <QDebug>
class SA_RIBBON_EXPORT SARibbonToolButton : public QToolButton
{
    Q_OBJECT
    SA_RIBBON_DECLARE_PRIVATE(SARibbonToolButton)
public:
    enum RibbonButtonType
    {
        LargeButton,
 
        SmallButton
    };
    Q_ENUM(RibbonButtonType)
 
    
    struct LayoutFactor
    {
        qreal twoLineHeightFactor { 2.05 };
 
        qreal oneLineHeightFactor { 1.2 };
 
        qreal buttonMaximumAspectRatio { 1.4 };
    };
 
public:
    explicit SARibbonToolButton(QWidget* parent = nullptr);
    explicit SARibbonToolButton(QAction* defaultAction, QWidget* parent = nullptr);
    ~SARibbonToolButton();
 
    // Gets the current button type (LargeButton or SmallButton) / 获取当前按钮的类型（大按钮或小按钮）
    RibbonButtonType buttonType() const;
    // Sets the button type to LargeButton or SmallButton / 设置按钮类型为大按钮或小按钮
    void setButtonType(const RibbonButtonType& buttonType);
 
    // Checks if the button is a small ribbon button / 判断按钮是否为小Ribbon按钮
    bool isSmallRibbonButton() const;
    //  Checks if the button is a large ribbon button / 判断按钮是否为大Ribbon按钮
    bool isLargeRibbonButton() const;
 
    // Gets the current spacing value / 获取当前的间距值
    int spacing() const;
    // Sets the spacing between elements and the border / 设置元素与边框之间的间距
    void setSpacing(int v);
 
    // Forces an update of the internal layout rectangles / 强制更新内部布局矩形
    void updateRect();
 
    // Sets the layout factor for fine-tuning the button's appearance / 设置布局系数以微调按钮外观
    void setLayoutFactor(const LayoutFactor& fac);
    // layout factor for fine-tuning the button's appearance / 布局系数以微调按钮外观
    const LayoutFactor& layoutFactor() const;
    LayoutFactor& layoutFactor();
 
    // Enables or disables automatic text wrapping for large buttons / 为大按钮启用或禁用自动文字换行
    void setEnableWordWrap(bool on);
    // Checks if automatic text wrapping is enabled / 检查是否启用了自动文字换行
    bool isEnableWordWrap();
 
    // Sets the button's maximum aspect ratio (width/height) / 设置按钮的最大宽高比
    void setButtonMaximumAspectRatio(qreal v = 1.4);
    // Gets the button's maximum aspect ratio (width/height) / 获取按钮的最大宽高比
    qreal buttonMaximumAspectRatio() const;
 
    // Invalidates the cached size hint / 使缓存的size hint失效
    void invalidateSizeHint();
 
public:
    virtual QSize sizeHint() const Q_DECL_OVERRIDE;
    virtual QSize minimumSizeHint() const Q_DECL_OVERRIDE;
 
protected:
    virtual void paintEvent(QPaintEvent* e) Q_DECL_OVERRIDE;
    virtual void resizeEvent(QResizeEvent* e) Q_DECL_OVERRIDE;
    virtual void mouseMoveEvent(QMouseEvent* e) Q_DECL_OVERRIDE;
    virtual void mousePressEvent(QMouseEvent* e) Q_DECL_OVERRIDE;
    virtual void mouseReleaseEvent(QMouseEvent* e) Q_DECL_OVERRIDE;
    virtual void focusOutEvent(QFocusEvent* e) Q_DECL_OVERRIDE;
    virtual void leaveEvent(QEvent* e) Q_DECL_OVERRIDE;
    virtual bool hitButton(const QPoint& pos) const Q_DECL_OVERRIDE;
    virtual bool event(QEvent* e) Q_DECL_OVERRIDE;
    virtual void changeEvent(QEvent* e) Q_DECL_OVERRIDE;
    virtual void actionEvent(QActionEvent* e) Q_DECL_OVERRIDE;
 
    // Paints the button's background and frame / 绘制按钮的背景和边框
    virtual void paintButton(QPainter& p, const QStyleOptionToolButton& opt);
    // Paints the button's icon / 绘制按钮的图标
    virtual void paintIcon(QPainter& p, const QStyleOptionToolButton& opt, const QRect& iconDrawRect);
    // Paints the button's text / 绘制按钮的文字
    virtual void paintText(QPainter& p, const QStyleOptionToolButton& opt, const QRect& textDrawRect);
    // Paints the button's indicator (e.g., dropdown arrow) / 绘制按钮的指示器（例如下拉箭头）
    virtual void paintIndicator(QPainter& p, const QStyleOptionToolButton& opt, const QRect& indicatorDrawRect);
 
private:
    static void drawArrow(const QStyle* style,
                          const QStyleOptionToolButton* toolbutton,
                          const QRect& rect,
                          QPainter* painter,
                          const QWidget* widget = 0);
};
 
namespace SA
{
QDebug operator<<(QDebug debug, const QStyleOptionToolButton& opt);
}
#endif  // SARIBBONTOOLBUTTON_H