114 lines
4.8 KiB
C
114 lines
4.8 KiB
C
|
#ifndef SARIBBONPANNELLAYOUT_H
|
|||
|
|
#define SARIBBONPANNELLAYOUT_H
|
|||
|
|
#include "SARibbonGlobal.h"
|
|||
|
|
#include <QLayout>
|
|||
|
|
#include "SARibbonPannelItem.h"
|
|||
|
|
class QToolButton;
|
|||
|
|
class SARibbonPannel;
|
|||
|
|
class SARibbonPannelLabel;
|
|||
|
|
/**
|
|||
|
|
* @brief 针对SARibbonPannel的布局
|
|||
|
|
*
|
|||
|
|
* SARibbonPannelLayout实际是一个列布局，每一列有2~3行，看窗口定占几行
|
|||
|
|
*
|
|||
|
|
* 核心函数： @ref SARibbonPannelLayout::createItem
|
|||
|
|
*
|
|||
|
|
* @note QLayout::contentsMargins 函数不会启作用,如果要设置contentsMargins，使用@sa setPannelContentsMargins
|
|||
|
|
*/
|
|||
|
|
class SA_RIBBON_EXPORT SARibbonPannelLayout : public QLayout
|
|||
|
|
{
|
|||
|
|
Q_OBJECT
|
|||
|
|
friend class SARibbonPannel;
|
|||
|
|
|
|||
|
|
public:
|
|||
|
|
SARibbonPannelLayout(QWidget* p = 0);
|
|||
|
|
~SARibbonPannelLayout();
|
|||
|
|
// SARibbonPannelLayout additem 无效
|
|||
|
|
void addItem(QLayoutItem* item) Q_DECL_OVERRIDE;
|
|||
|
|
// QLayout 所必须的重载函数
|
|||
|
|
QLayoutItem* itemAt(int index) const Q_DECL_OVERRIDE;
|
|||
|
|
QLayoutItem* takeAt(int index) Q_DECL_OVERRIDE;
|
|||
|
|
int count() const Q_DECL_OVERRIDE;
|
|||
|
|
bool isEmpty() const Q_DECL_OVERRIDE;
|
|||
|
|
void invalidate() Q_DECL_OVERRIDE;
|
|||
|
|
Qt::Orientations expandingDirections() const Q_DECL_OVERRIDE;
|
|||
|
|
void setGeometry(const QRect& rect) Q_DECL_OVERRIDE;
|
|||
|
|
QSize minimumSize() const Q_DECL_OVERRIDE;
|
|||
|
|
QSize sizeHint() const Q_DECL_OVERRIDE;
|
|||
|
|
|
|||
|
|
// 获取ribbonpannel
|
|||
|
|
SARibbonPannel* ribbonPannel() const;
|
|||
|
|
// SARibbonPannel主要通过此函数来添加action
|
|||
|
|
void insertAction(int index, QAction* act, SARibbonPannelItem::RowProportion rp = SARibbonPannelItem::None);
|
|||
|
|
// 设置OptionAction，如果要去除，传入nullptr指针即可
|
|||
|
|
void setOptionAction(QAction* action);
|
|||
|
|
bool isHaveOptionAction() const;
|
|||
|
|
// 通过action获取SARibbonPannelItem
|
|||
|
|
SARibbonPannelItem* pannelItem(QAction* action) const;
|
|||
|
|
// 获取最后一个添加的item
|
|||
|
|
SARibbonPannelItem* lastItem() const;
|
|||
|
|
// 获取最后生成的窗口
|
|||
|
|
QWidget* lastWidget() const;
|
|||
|
|
// 移动两个item
|
|||
|
|
void move(int from, int to);
|
|||
|
|
// 判断是否需要重新布局
|
|||
|
|
bool isDirty() const;
|
|||
|
|
// 更新尺寸
|
|||
|
|
void updateGeomArray();
|
|||
|
|
// 通过action获取SARibbonPannelItem的索引
|
|||
|
|
int indexByAction(QAction* action) const;
|
|||
|
|
// 标题高度
|
|||
|
|
int pannelTitleHeight() const;
|
|||
|
|
void setPannelTitleHeight(int newTitleHeight);
|
|||
|
|
// 判断是否存在标题
|
|||
|
|
bool isEnableShowPannelTitle() const;
|
|||
|
|
void setEnableShowPannelTitle(bool on);
|
|||
|
|
// 返回大按钮的高度
|
|||
|
|
int largeButtonHeight() const;
|
|||
|
|
// 标题区域和按钮的间隔
|
|||
|
|
int pannelTitleSpace() const;
|
|||
|
|
void setPannelTitleSpace(int newTitleSpace);
|
|||
|
|
// pannel 标题的label
|
|||
|
|
SARibbonPannelLabel* pannelTitleLabel() const;
|
|||
|
|
// 设置按钮的icon尺寸，large action不受此尺寸影响
|
|||
|
|
void setToolButtonIconSize(const QSize& s);
|
|||
|
|
QSize toolButtonIconSize() const;
|
|||
|
|
|
|||
|
|
protected:
|
|||
|
|
// 获取optionAction 按钮尺寸
|
|||
|
|
QSize optionActionButtonSize() const;
|
|||
|
|
// 布局action
|
|||
|
|
void doLayout();
|
|||
|
|
// 把action转换为item，对于纯Action，此函数会创建SARibbonToolButton,
|
|||
|
|
// rp用于告诉Layout生成什么样的窗口，详细见SARibbonPannelItem::RowProportion
|
|||
|
|
SARibbonPannelItem* createItem(QAction* action, SARibbonPannelItem::RowProportion rp = SARibbonPannelItem::None);
|
|||
|
|
void updateGeomArray(const QRect& setrect);
|
|||
|
|
// 重新计算扩展条码，此函数必须在updateGeomArray函数之后调用
|
|||
|
|
void recalcExpandGeomArray(const QRect& setrect);
|
|||
|
|
// 返回optionActionButton的尺寸
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
// 根据列数，计算窗口的宽度，以及最大宽度
|
|||
|
|
void columnWidthInfo(int colindex, int& width, int& maximum) const;
|
|||
|
|
// 设置titlelabel
|
|||
|
|
void setPannelTitleLabel(SARibbonPannelLabel* newTitleLabel);
|
|||
|
|
|
|||
|
|
private:
|
|||
|
|
QList< SARibbonPannelItem* > mItems;
|
|||
|
|
int mColumnCount { 0 }; ///< 记录有多少列
|
|||
|
|
bool mExpandFlag { false }; ///< 标记是否是会扩展的
|
|||
|
|
QSize mSizeHint; ///< sizeHint返回的尺寸
|
|||
|
|
QSize mDefaultToolButtonIconSize { 22, 22 }; ///< 记录默认的按钮图标尺寸
|
|||
|
|
bool mDirty { true }; ///< 用于标记是否需要刷新元素，参考QToolBarLayout源码
|
|||
|
|
int mLargeHeight { 0 }; ///< 记录大图标的高度
|
|||
|
|
int mTitleHeight { 15 }; ///< 标题区域高度
|
|||
|
|
int mTitleSpace { 2 }; ///< 标题区域和按钮的间隔
|
|||
|
|
bool mEnableShowTitle { true }; ///< 是否运行显示pannel标题
|
|||
|
|
SARibbonPannelLabel* mTitleLabel { nullptr }; ///< titlelabel指针
|
|||
|
|
QRect mTitleLabelGeometry; ///< titlelabel的位置
|
|||
|
|
QToolButton* mOptionActionBtn { nullptr }; ///< optionAction对应的button
|
|||
|
|
QRect mOptionActionBtnGeometry; ///< optionAction的位置
|
|||
|
|
};
|
|||
|
|
|
|||
|
|
#endif // SARIBBONPANNELLAYOUT_H
|