SARibbonButtonLayoutStrategy.h

#ifndef SARIBBONBUTTONLAYOUTSTRATEGY_H
#define SARIBBONBUTTONLAYOUTSTRATEGY_H
 
#include "SARibbonGlobal.h"
#include <QStyleOptionToolButton>
#include <QSize>
#include <QRect>
#include <memory>
 
class QFontMetrics;
class QWidget;
class SARibbonToolButton;  // 前向声明
 
enum class SARibbonButtonType
{
    LargeButton,
    SmallButton
};
 
struct SA_RIBBON_EXPORT SARibbonButtonLayoutRects
{
    QRect iconRect;       
    QRect textRect;       
    QRect indicatorRect;  
 
    void clear()
    {
        iconRect      = QRect();
        textRect      = QRect();
        indicatorRect = QRect();
    }
 
    bool isValid() const
    {
        return iconRect.isValid() || textRect.isValid() || indicatorRect.isValid();
    }
};
 
struct SA_RIBBON_EXPORT SARibbonButtonLayoutContext
{
    const QWidget* buttonWidget { nullptr };  
    int spacing { 1 };                        
    int indicatorLength { 8 };                
    QSize largeIconSize { 32, 32 };           
    QSize smallIconSize { 16, 16 };           
    qreal twoLineHeightFactor { 2.05 };       
    qreal oneLineHeightFactor { 1.2 };        
    qreal buttonMaximumAspectRatio { 1.4 };   
    bool enableWordWrap { true };             
    mutable bool isTextNeedWrap { false };    
    int maximumWidth { QWIDGETSIZE_MAX };     
 
    SARibbonButtonLayoutContext() = default;
    explicit SARibbonButtonLayoutContext(const SARibbonToolButton* btn);
};
 
class SA_RIBBON_EXPORT SARibbonButtonLayoutStrategy
{
public:
    virtual ~SARibbonButtonLayoutStrategy() = default;
 
    virtual void calculateDrawRects(const QStyleOptionToolButton& opt,
                                    SARibbonButtonLayoutRects& rects,
                                    const SARibbonButtonLayoutContext& ctx) const = 0;
 
    virtual QSize calculateSizeHint(const QStyleOptionToolButton& opt, const SARibbonButtonLayoutContext& ctx) const = 0;
 
    virtual int calculateTextHeight(const QStyleOptionToolButton& opt, const SARibbonButtonLayoutContext& ctx) const = 0;
 
    virtual int estimateTextWidth(int buttonHeight,
                                  int textHeight,
                                  const QString& text,
                                  const QFontMetrics& fm,
                                  SARibbonButtonLayoutContext& ctx) const;  // 非const因为可能修改ctx.isTextNeedWrap
 
protected:
    static bool hasIndicator(const QStyleOptionToolButton& opt);
 
    static QSize adjustIconSize(const QRect& buttonRect, const QSize& originIconSize);
 
    static QString simplifiedText(const QString& str);
};
 
class SA_RIBBON_EXPORT SARibbonLargeButtonLayoutStrategy : public SARibbonButtonLayoutStrategy
{
public:
    void calculateDrawRects(const QStyleOptionToolButton& opt,
                            SARibbonButtonLayoutRects& rects,
                            const SARibbonButtonLayoutContext& ctx) const override;
 
    QSize calculateSizeHint(const QStyleOptionToolButton& opt, const SARibbonButtonLayoutContext& ctx) const override;
 
    int calculateTextHeight(const QStyleOptionToolButton& opt, const SARibbonButtonLayoutContext& ctx) const override;
 
private:
    void calculateIconOnlyRects(const QStyleOptionToolButton& opt,
                                SARibbonButtonLayoutRects& rects,
                                const SARibbonButtonLayoutContext& ctx) const;
 
    void calculateTextOnlyRects(const QStyleOptionToolButton& opt,
                                SARibbonButtonLayoutRects& rects,
                                const SARibbonButtonLayoutContext& ctx) const;
 
    void calculateIconAndTextRects(const QStyleOptionToolButton& opt,
                                   SARibbonButtonLayoutRects& rects,
                                   const SARibbonButtonLayoutContext& ctx) const;
};
 
class SA_RIBBON_EXPORT SARibbonSmallButtonLayoutStrategy : public SARibbonButtonLayoutStrategy
{
public:
    void calculateDrawRects(const QStyleOptionToolButton& opt,
                            SARibbonButtonLayoutRects& rects,
                            const SARibbonButtonLayoutContext& ctx) const override;
 
    QSize calculateSizeHint(const QStyleOptionToolButton& opt, const SARibbonButtonLayoutContext& ctx) const override;
 
    int calculateTextHeight(const QStyleOptionToolButton& opt, const SARibbonButtonLayoutContext& ctx) const override;
 
private:
    void calculateIconOnlyRects(const QStyleOptionToolButton& opt,
                                SARibbonButtonLayoutRects& rects,
                                const SARibbonButtonLayoutContext& ctx) const;
 
    void calculateTextOnlyRects(const QStyleOptionToolButton& opt,
                                SARibbonButtonLayoutRects& rects,
                                const SARibbonButtonLayoutContext& ctx) const;
 
    void calculateIconAndTextRects(const QStyleOptionToolButton& opt,
                                   SARibbonButtonLayoutRects& rects,
                                   const SARibbonButtonLayoutContext& ctx) const;
};
 
class SA_RIBBON_EXPORT SARibbonButtonLayoutStrategyFactory
{
public:
    static std::unique_ptr< SARibbonButtonLayoutStrategy > createStrategy(SARibbonButtonType type);
};
 
#endif  // SARIBBONBUTTONLAYOUTSTRATEGY_H