|
|
#ifndef SARIBBONCATEGORY_H
|
|
|
#define SARIBBONCATEGORY_H
|
|
|
#include "SARibbonGlobal.h"
|
|
|
#include <QFrame>
|
|
|
#include "SARibbonPannel.h"
|
|
|
#include <QScopedPointer>
|
|
|
#include <QPushButton>
|
|
|
#include <QWheelEvent>
|
|
|
|
|
|
class QAction;
|
|
|
class QHBoxLayout;
|
|
|
class QWheelEvent;
|
|
|
class SARibbonBar;
|
|
|
class SARibbonCategoryLayout;
|
|
|
/**
|
|
|
* @brief 一项ribbon tab页
|
|
|
* @note SARibbonCategory的windowTitle影响了其在SARibbonBar的标签显示，
|
|
|
* 如果要改标签名字，直接调用SARibbonCategory的setWindowTitle函数
|
|
|
*/
|
|
|
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 FpPannelIterate = std::function< bool(SARibbonPannel*) >;
|
|
|
|
|
|
public:
|
|
|
SARibbonCategory(QWidget* p = nullptr);
|
|
|
SARibbonCategory(const QString& name, QWidget* p = nullptr);
|
|
|
~SARibbonCategory();
|
|
|
|
|
|
// category的名字
|
|
|
QString categoryName() const;
|
|
|
|
|
|
// 设置category名字，等同setWindowTitle
|
|
|
void setCategoryName(const QString& title);
|
|
|
|
|
|
// 设置pannel的模式
|
|
|
SARibbonPannel::PannelLayoutMode pannelLayoutMode() const;
|
|
|
void setPannelLayoutMode(SARibbonPannel::PannelLayoutMode m);
|
|
|
|
|
|
// 添加pannel
|
|
|
SARibbonPannel* addPannel(const QString& title);
|
|
|
|
|
|
// 添加pannel
|
|
|
void addPannel(SARibbonPannel* pannel);
|
|
|
|
|
|
// qt designer专用
|
|
|
Q_INVOKABLE void addPannel(QWidget* pannel);
|
|
|
|
|
|
// 插入pannel
|
|
|
SARibbonPannel* insertPannel(const QString& title, int index);
|
|
|
|
|
|
// 通过名字查找pannel
|
|
|
SARibbonPannel* pannelByName(const QString& title) const;
|
|
|
|
|
|
// 通过ObjectName查找pannel
|
|
|
SARibbonPannel* pannelByObjectName(const QString& objname) const;
|
|
|
|
|
|
// 通过索引找到pannel，如果超过索引范围，会返回nullptr
|
|
|
SARibbonPannel* pannelByIndex(int index) const;
|
|
|
|
|
|
// 查找pannel的index
|
|
|
int pannelIndex(SARibbonPannel* p) const;
|
|
|
|
|
|
// 移动一个Pannel从from index到to index
|
|
|
void movePannel(int from, int to);
|
|
|
|
|
|
// 把pannel从Category中移除，不会销毁，此时pannel的所有权归还操作者
|
|
|
bool takePannel(SARibbonPannel* pannel);
|
|
|
|
|
|
// 移除Pannel，Category会直接回收SARibbonPannel内存
|
|
|
bool removePannel(SARibbonPannel* pannel);
|
|
|
bool removePannel(int index);
|
|
|
|
|
|
// 返回所有的Pannel
|
|
|
QList< SARibbonPannel* > pannelList() const;
|
|
|
|
|
|
//
|
|
|
QSize sizeHint() const Q_DECL_OVERRIDE;
|
|
|
|
|
|
// 如果是ContextCategory，此函数返回true
|
|
|
bool isContextCategory() const;
|
|
|
|
|
|
// pannel的个数
|
|
|
int pannelCount() const;
|
|
|
|
|
|
// 判断是否可以自定义
|
|
|
bool isCanCustomize() const;
|
|
|
void setCanCustomize(bool b);
|
|
|
|
|
|
// 设置pannel的标题栏高度
|
|
|
int pannelTitleHeight() const;
|
|
|
void setPannelTitleHeight(int h);
|
|
|
|
|
|
// 设置pannel是否显示标题栏
|
|
|
bool isEnableShowPannelTitle() const;
|
|
|
void setEnableShowPannelTitle(bool on);
|
|
|
|
|
|
// 设置Category的对齐方式
|
|
|
void setCategoryAlignment(SARibbonAlignment al);
|
|
|
SARibbonAlignment categoryAlignment() const;
|
|
|
|
|
|
// 获取对应的ribbonbar，如果没有加入ribbonbar的管理，此值为null
|
|
|
SARibbonBar* ribbonBar() const;
|
|
|
|
|
|
// 刷新category的尺寸布局
|
|
|
void updateItemGeometry();
|
|
|
|
|
|
// 此函数会遍历Category下的所有pannel,执行函数指针，函数指针返回false则停止迭代
|
|
|
bool iterate(FpPannelIterate fp);
|
|
|
signals:
|
|
|
/**
|
|
|
* @brief category标题发生了改变信号
|
|
|
* @param n
|
|
|
*/
|
|
|
void categoryNameChanged(const QString& n);
|
|
|
|
|
|
/**
|
|
|
* @brief 参考QToolBar::actionTriggered的信号
|
|
|
* @param action
|
|
|
*/
|
|
|
void actionTriggered(QAction* action);
|
|
|
|
|
|
protected:
|
|
|
virtual bool event(QEvent* e) Q_DECL_OVERRIDE;
|
|
|
// 处理滚轮事件
|
|
|
void wheelEvent(QWheelEvent* event) Q_DECL_OVERRIDE;
|
|
|
//
|
|
|
void changeEvent(QEvent* event) Q_DECL_OVERRIDE;
|
|
|
|
|
|
// 标记这个是上下文标签
|
|
|
void markIsContextCategory(bool isContextCategory = true);
|
|
|
|
|
|
// 获取SARibbonCategoryLayoutlayout
|
|
|
SARibbonCategoryLayout* categoryLayout() const;
|
|
|
};
|
|
|
|
|
|
/**
|
|
|
* @brief SARibbonCategory无法完全显示时，显示的调整按钮
|
|
|
*
|
|
|
* 重新定义是为了防止被外部的样式影响,同时可以使用SARibbonCategoryScrollButton的样式定义
|
|
|
*/
|
|
|
class SA_RIBBON_EXPORT SARibbonCategoryScrollButton : public QToolButton
|
|
|
{
|
|
|
Q_OBJECT
|
|
|
public:
|
|
|
SARibbonCategoryScrollButton(Qt::ArrowType arr, QWidget* p = nullptr);
|
|
|
};
|
|
|
|
|
|
#endif // SARIBBONCATEGORY_H
|