SARibbonToolButton.h

#ifndef SARIBBONTOOLBUTTON_H
#define SARIBBONTOOLBUTTON_H
#include "SARibbonGlobal.h"
#include <QToolButton>
#include <QDebug>
 
// 前向声明
class SARibbonButtonLayoutStrategy;
struct SARibbonButtonLayoutContext;
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 };  // Note: Kept as literal for header inline initialization compatibility
 
        qreal oneLineHeightFactor { 1.2 };
 
        qreal buttonMaximumAspectRatio { 1.4 };
    };
 
public:
    explicit SARibbonToolButton(QWidget* parent = nullptr);
    explicit SARibbonToolButton(QAction* defaultAction, QWidget* parent = nullptr);
    ~SARibbonToolButton();
 
    // Get the current button type (LargeButton or SmallButton)
    RibbonButtonType buttonType() const;
    // Set the button type to LargeButton or SmallButton
    void setButtonType(const RibbonButtonType& buttonType);
 
    void setEnableIconRightText(bool on);
    bool isEnableIconRightText() const;
 
    // Check if the button is a small ribbon button
    bool isSmallRibbonButton() const;
    // Check if the button is a large ribbon button
    bool isLargeRibbonButton() const;
 
    // Get the current spacing value
    int spacing() const;
    // Set the spacing between elements and the border
    void setSpacing(int v);
 
    // Force an update of the internal layout rectangles
    void updateRect();
 
    // Set the layout factor for fine-tuning the button's appearance
    void setLayoutFactor(const LayoutFactor& fac);
    // Get the layout factor for fine-tuning the button's appearance (const version)
    const LayoutFactor& layoutFactor() const;
    // Get the layout factor for fine-tuning the button's appearance (non-const version)
    LayoutFactor& layoutFactor();
 
    // Enables or disables automatic text wrapping for large buttons / 为大按钮启用或禁用自动文字换行
    void setEnableWordWrap(bool on);
    // Checks if automatic text wrapping is enabled / 检查是否启用了自动文字换行
    bool isEnableWordWrap() const;
 
    // 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();
 
    // 大按钮尺寸
    void setLargeIconSize(const QSize& largeSize);
    QSize largeIconSize() const;
 
    // 小按钮尺寸
    void setSmallIconSize(const QSize& smallSize);
    QSize smallIconSize() const;
 
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);
 
    virtual QPixmap createIconPixmap(const QStyleOptionToolButton& opt, const QSize& iconSize) const;
 
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