148 lines
4.8 KiB
C++
148 lines
4.8 KiB
C++
#ifndef SARIBBONGLOBAL_H
|
||
#define SARIBBONGLOBAL_H
|
||
#include <memory>
|
||
#include <QtGlobal>
|
||
#include <QObject>
|
||
#include "SARibbonBarVersionInfo.h"
|
||
class QWidget;
|
||
|
||
#ifndef SA_RIBBON_BAR_NO_EXPORT
|
||
#if defined(SA_RIBBON_BAR_MAKE_LIB) // 定义此宏将构建library
|
||
#define SA_RIBBON_EXPORT Q_DECL_EXPORT
|
||
#else
|
||
#define SA_RIBBON_EXPORT Q_DECL_IMPORT
|
||
#endif
|
||
#endif
|
||
#ifndef SA_RIBBON_EXPORT
|
||
#define SA_RIBBON_EXPORT
|
||
#endif
|
||
|
||
/**
|
||
* @def 模仿Q_DECLARE_PRIVATE，但不用前置声明而是作为一个内部类
|
||
*/
|
||
#ifndef SA_RIBBON_DECLARE_PRIVATE
|
||
#define SA_RIBBON_DECLARE_PRIVATE(classname) \
|
||
class PrivateData; \
|
||
friend class classname::PrivateData; \
|
||
std::unique_ptr< PrivateData > d_ptr;
|
||
#endif
|
||
/**
|
||
* @def 模仿Q_DECLARE_PUBLIC
|
||
*/
|
||
#ifndef SA_RIBBON_DECLARE_PUBLIC
|
||
#define SA_RIBBON_DECLARE_PUBLIC(classname) \
|
||
friend class classname; \
|
||
classname* q_ptr { nullptr }; \
|
||
PrivateData(const PrivateData&) = delete; \
|
||
PrivateData& operator=(const PrivateData&) = delete;
|
||
#endif
|
||
|
||
/**
|
||
* @brief 定义Ribbon的对其方式，目前支持左对齐和居中对其
|
||
*/
|
||
enum class SARibbonAlignment
|
||
{
|
||
AlignLeft, ///< 左对齐，tab栏左对齐，同时category也是左对齐
|
||
AlignCenter ///< 居中对其，tab栏居中对齐，同时category也是居中对齐
|
||
};
|
||
|
||
/**
|
||
* @brief ribbon主题
|
||
*
|
||
* 注意，由于有些qss的尺寸，在C++代码中无法获取到，因此针对用户自定义的qss主题，有些尺寸是需要手动设置进去的
|
||
*
|
||
* 例如ribbon tab的margin信息，在QTabBar是无法获取到，而这个影响了SARibbonContextCategory的绘制，
|
||
* 因此，在设置qss后需要针对margin信息重新设置进SARibbonTabBar中
|
||
*/
|
||
enum class SARibbonTheme
|
||
{
|
||
RibbonThemeOffice2013, ///< office2013主题
|
||
RibbonThemeOffice2016Blue, ///< office2016-蓝色主题
|
||
RibbonThemeOffice2021Blue, ///< office2021-蓝色主题
|
||
RibbonThemeWindows7, ///< win7主题
|
||
RibbonThemeDark, ///< 暗色主题
|
||
RibbonThemeDark2
|
||
};
|
||
|
||
/**
|
||
* @def 属性，用于标记是否可以进行自定义，用于动态设置到@ref SARibbonCategory 和@ref SARibbonPannel
|
||
* 值为bool，在为true时，可以通过@ref SARibbonCustomizeWidget 改变这个SARibbonCategory和SARibbonPannel的布局，
|
||
* 默认不会有此属性，仅在有此属性且为true时才会在SARibbonCustomizeWidget中能显示为可设置
|
||
*/
|
||
#ifndef SA_RIBBON_BAR_PROP_CAN_CUSTOMIZE
|
||
#define SA_RIBBON_BAR_PROP_CAN_CUSTOMIZE "_sa_isCanCustomize"
|
||
#endif
|
||
|
||
#if (QT_VERSION >= QT_VERSION_CHECK(5, 11, 0))
|
||
#ifndef SA_FONTMETRICS_WIDTH
|
||
#define SA_FONTMETRICS_WIDTH(fm, str) fm.horizontalAdvance(str)
|
||
#endif
|
||
#else
|
||
#ifndef SA_FONTMETRICS_WIDTH
|
||
#define SA_FONTMETRICS_WIDTH(fm, str) fm.width(str)
|
||
#endif
|
||
#endif
|
||
|
||
#if (QT_VERSION >= QT_VERSION_CHECK(6, 0, 0))
|
||
#ifndef SA_MOUSEEVENT_GLOBALPOS_POINT
|
||
#define SA_MOUSEEVENT_GLOBALPOS_POINT(MouseEventPtr) MouseEventPtr->globalPosition().toPoint()
|
||
#endif
|
||
#else
|
||
#ifndef SA_MOUSEEVENT_GLOBALPOS_POINT
|
||
#define SA_MOUSEEVENT_GLOBALPOS_POINT(MouseEventPtr) MouseEventPtr->globalPos()
|
||
#endif
|
||
#endif
|
||
|
||
#if (QT_VERSION >= QT_VERSION_CHECK(6, 0, 0))
|
||
#ifndef SA_HOVEREVENT_POS_POINT
|
||
#define SA_HOVEREVENT_POS_POINT(HoverEventPtr) HoverEventPtr->position().toPoint()
|
||
#endif
|
||
#else
|
||
#ifndef SA_HOVEREVENT_POS_POINT
|
||
#define SA_HOVEREVENT_POS_POINT(HoverEventPtr) HoverEventPtr->pos()
|
||
#endif
|
||
#endif
|
||
|
||
/**
|
||
@def 定义此宏，将打印和尺寸刷新相关的信息
|
||
|
||
仅用于调试
|
||
*/
|
||
#ifndef SA_DEBUG_PRINT_SIZE_HINT
|
||
#define SA_DEBUG_PRINT_SIZE_HINT 0
|
||
#endif
|
||
|
||
/**
|
||
@def 定义此宏，将打印事件
|
||
|
||
仅用于调试
|
||
*/
|
||
#ifndef SA_DEBUG_PRINT_EVENT
|
||
#define SA_DEBUG_PRINT_EVENT 0
|
||
#endif
|
||
|
||
/**
|
||
@def 定义此宏，qDebug将支持SARibbonBar的属性打印
|
||
|
||
仅用于调试
|
||
*/
|
||
#ifndef SA_DEBUG_PRINT_SARIBBONBAR
|
||
#define SA_DEBUG_PRINT_SARIBBONBAR 0
|
||
#endif
|
||
|
||
/**
|
||
* @brief 全局的设置ribbon theme函数
|
||
*
|
||
* 之所以提供此函数，是因为在某些情况下，SARibbonBar不用在SARibbonMainWindow情况下的时候，也需要设置主题，
|
||
* 但主题设置是在SARibbonMainWindow下的为了能在非SARibbonMainWindow下也能设置主题，这里提供@sa sa_set_ribbon_theme函数，
|
||
* 可以这样使用：
|
||
* @code
|
||
* @endcode
|
||
*
|
||
* @param w
|
||
* @param theme
|
||
*/
|
||
void SA_RIBBON_EXPORT sa_set_ribbon_theme(QWidget* w, SARibbonTheme theme);
|
||
|
||
#endif // SARIBBONGLOBAL_H
|