#ifndef UI_CORE_WINDOWHELPER_H_ #define UI_CORE_WINDOWHELPER_H_ #pragma once #include "Image.h" #include "Window.h" namespace ui { /** * @brief 全局属性管理工具类 * 用于管理一些全局属性的工具类，包含全局样式（global.xml）和语言设置等 */ class UILIB_API GlobalManager { public: /** * @brief 初始化全局设置函数 * @param[in] strResourcePath 资源路径位置 * @param[in] callback 创建自定义控件时的全局回调函数 * @param[in] bAdaptDpi 是否启用 DPI 适配 * @param[in] theme 主题目录名，默认为 themes\\default * @param[in] language 使用语言，默认为 lang\\zh_CN * @return 无 */ static void Startup(const std::wstring& strResourcePath, const CreateControlCallback& callback, bool bAdaptDpi, const std::wstring& theme = L"themes\\default", const std::wstring& language = L"lang\\zh_CN"); /** * @brief 释放资源 * @return 无 */ static void Shutdown(); /** * @brief 获取当前程序所在目录 * @return 返回当前程序所在目录 */ static std::wstring GetCurrentPath(); /** * @brief 获取当前资源所在目录 * @return 返回当前资源所在目录 */ static std::wstring GetResourcePath(); /** * @brief 设置程序当前目录 * @param[in] strPath 要设置的路径 * @return 无 */ static void SetCurrentPath(const std::wstring& strPath); /** * @brief 设置皮肤资源所在目录 * @param[in] strPath 要设置的路径 * @return 无 */ static void SetResourcePath(const std::wstring& strPath); /** * @brief 重新加载皮肤资源 * @param[in] resourcePath 资源路径 * @return 无 */ static void ReloadSkin(const std::wstring& resourcePath); /** * @brief 获取绘制接口类对象 * @return 返回接口类对象指针 */ static IRenderFactory* GetRenderFactory(); /** * @brief 创建全局的绘制上下文区域 * @return 返回绘制区域对象 */ static std::unique_ptr CreateRenderContext(); /** * @brief 创建一个画笔 * @param[in] color 画笔颜色 * @param[in] width 画笔宽度 * @return 返回画笔对象 */ static std::unique_ptr CreatePen(DWORD color, int width = 1); /** * @brief 创建一个画刷 * @param[in] color 画刷颜色 * @return 返回画刷对象 */ static std::unique_ptr CreateBrush(DWORD color); /** * @brief 创建一个矩阵 * @return 返回矩阵对象 */ static std::unique_ptr CreateMatrix(); /** * @brief 创建一个绘制路径 * @return 返回绘制路径对象 */ static std::unique_ptr CreatePath(); /** * @brief 添加一个全局 class 属性 * @param[in] strClassName 全局 class 名称 * @param[in] strControlAttrList 属性列表，需要做 XML 转义 * @return 无 */ static void AddClass(const std::wstring& strClassName, const std::wstring& strControlAttrList); /** * @brief 获取一个全局 class 属性的值 * @param[in] strClassName 全局 class 名称 * @return 返回字符串形式的 class 属性值 */ static std::wstring GetClassAttributes(const std::wstring& strClassName); /** * @brief 从全局属性中删除所有 class 属性 * @return 返回绘制区域对象 */ static void RemoveAllClasss(); /** * @brief 添加一个全局颜色值提供程序使用 * @param[in] strName 颜色名称（如 white） * @param[in] strValue 颜色具体数值（如 #FFFFFFFF） * @return 无 */ static void AddTextColor(const std::wstring& strName, const std::wstring& strValue); /** * @brief 根据名称获取一个颜色的具体数值 * @param[in] strName 要获取的颜色名称 * @return 返回 DWORD 格式的颜色描述值 */ static DWORD GetTextColor(const std::wstring& strName); /** * @brief 删除所有全局颜色属性 * @return 无 */ static void RemoveAllTextColors(); /** * @brief 检查指定图片是否已经被缓存 * @param[in] bitmap 图片路径 * @return 如果已经被缓存，则返回 ImageInfo 的智能指针对象 */ static std::shared_ptr IsImageCached(const std::wstring& bitmap); /** * @brief 添加一个图片到缓存中 * @param[in] shared_image * @return 返回被缓存的 ImageInfo 智能指针对象 */ static std::shared_ptr AddImageCached(const std::shared_ptr& shared_image); /** * @brief 从缓存中一处一个图片 * @param[in] imageFullPath 图片路径 * @return 无 */ static void RemoveFromImageCache(const std::wstring& imageFullPath); /** * @brief 图片被销毁的回调 * @param[in] pImageInfo 图片对应的 ImageInfo 对象 * @return 无 */ static void OnImageInfoDestroy(ImageInfo *pImageInfo); /** * @brief 获取图片 ImageInfo 对象 * @param[in] bitmap 图片路径 * @return 返回图片 ImageInfo 对象的智能指针 */ static std::shared_ptr GetImage(const std::wstring& bitmap); /** * @brief 从缓存中删除所有图片 * @return 无 */ static void RemoveAllImages(); /** * @brief 获取默认字体名称 * @return 字体名称 */ static std::wstring GetDefaultFontName(); /** * @brief 添加一个字体 * @param[in] strFontId 指定字体的ID标记 * @param[in] strFontName 字体名称 * @param[in] nSize 字体大小 * @param[in] bBold 是否粗体 * @param[in] bUnderline 是否有下划线 * @param[in] bItalic 是否倾斜 * @param[in] bDefault 是否默认 * @return 返回字体的 HFONT 句柄 */ static HFONT AddFont(const std::wstring& strFontId, const std::wstring& strFontName, int nSize, bool bBold, bool bUnderline, bool bItalic, bool bDefault); /** * @brief 根据索引返回一个字体信息 * @param[in] strFontId 字体ID * @return 返回字体的 TFontInfo 信息 */ static TFontInfo* GetTFontInfo(const std::wstring& strFontId); /** * @brief 根据字体ID返回一个字体对象 * @param[in] strFontId 字体ID * @return 返回字体的 HFONT 句柄 */ static HFONT GetFont(const std::wstring& strFontId); /** * @brief 根据字体属性获取字体对象 * @param[in] strFontName 字体名称 * @param[in] nSize 字体大小 * @param[in] bBold 是否粗体 * @param[in] bUnderline 是否有下划线 * @param[in] bItalic 是否倾斜 * @return 返回字体的 HFONT 句柄 */ static HFONT GetFont(const std::wstring& strFontName, int nSize, bool bBold, bool bUnderline, bool bItalic); /** * @brief 获取字体信息 * @param[in] strFontId 字体ID * @param[in] hDcPaint 设备句柄 * @return 返回字体的 TFontInfo 信息 */ static TFontInfo* GetFontInfo(const std::wstring& strFontId, HDC hDcPaint); /** * @brief 获取字体信息 * @param[in] hFont 字体对象句柄 * @param[in] hDcPaint 设备句柄 * @return 返回字体的 TFontInfo 信息 */ static TFontInfo* GetFontInfo(HFONT hFont, HDC hDcPaint); /** * @brief 根据字体对象查找指定字体是否存在 * @param[in] hFont 字体对象句柄 * @return 返回是否存在 * @retval true 存在 * @retval false 不存在 */ static bool FindFont(HFONT hFont); /** * @brief 根据字体信息查找字体是否存在 * @param[in] strFontName 字体名称 * @param[in] nSize 字体大小 * @param[in] bBold 是否粗体 * @param[in] bUnderline 是否有下划线 * @param[in] bItalic 是否倾斜 * @return 返回是否存在 * @retval true 存在 * @retval false 不存在 */ static bool FindFont(const std::wstring& strFontName, int nSize, bool bBold, bool bUnderline, bool bItalic); /** * @brief 根据字体索引删除字体 * @param[in] strFontId 字体ID * @return 返回是否删除成功 * @retval true 删除成功 * @retval false 字体不存在或删除失败 */ static bool RemoveFontAt(const std::wstring& strFontId); /** * @brief 删除所有字体 * @return 无 */ static void RemoveAllFonts(); /** * @brief 获取默认禁用状态下字体颜色 * @return 默认禁用状态颜色的字符串表示，对应 global.xml 中指定颜色值 */ static std::wstring GetDefaultDisabledTextColor(); /** * @brief 设置默认禁用状态下的字体颜色 * @param[in] dwColor 字体颜色字符串值（如 white） * @return 无 */ static void SetDefaultDisabledTextColor(const std::wstring& strColor); /** * @brief 获取默认字体颜色 * @return 默认字体颜色字符串表示，对应 global.xml 中指定颜色值 */ static std::wstring GetDefaultTextColor(); /** * @brief 设置默认字体颜色 * @param[in] 字体颜色的字符串值，对应 global.xml 中指定颜色值 * @return 无 */ static void SetDefaultTextColor(const std::wstring& strColor); /** * @brief 获取默认链接字体颜色 * @return 链接字体颜色 DWORD 格式的色值 */ static DWORD GetDefaultLinkFontColor(); /** * @brief 设置默认链接字体颜色 * @param[in] dwColor 默认链接字体颜色 * @return 无 */ static void SetDefaultLinkFontColor(DWORD dwColor); /** * @brief 获取焦点链接的默认字体颜色 * @return 返回焦点链接的默认字体颜色 */ static DWORD GetDefaultLinkHoverFontColor(); /** * @brief 设置焦点链接的默认字体颜色 * @param[in] dwColor 焦点链接的默认字体颜色 * @return 无 */ static void SetDefaultLinkHoverFontColor(DWORD dwColor); /** * @brief 获取默认选择状态字体颜色 * @return 返回默认选择状态的字体颜色 */ static DWORD GetDefaultSelectedBkColor(); /** * @brief 设置默认选择状态的字体颜色 * @param[in] dwColor 字体颜色值 * @return 无 */ static void SetDefaultSelectedBkColor(DWORD dwColor); /** * @brief 根据 XML 创建一个 Box * @param[in] strXmlPath XML 文件路径 * @param[in] callback 自定义控件的回调处理函数 * @return 指定布局模块的对象指针 */ static Box* CreateBox(const std::wstring& strXmlPath, CreateControlCallback callback = CreateControlCallback()); /** * @brief 根据 XML 在缓存中查找指定 Box，如果没有则创建 * @param[in] strXmlPath XML 文件路径 * @param[in] callback 自定义控件的回调处理函数 * @return 指定布局模块的对象指针 */ static Box* CreateBoxWithCache(const std::wstring& strXmlPath, CreateControlCallback callback = CreateControlCallback()); /** * @brief 使用 XML 填充指定 Box * @param[in] pUserDefinedBox 要填充的 box 指针 * @param[in] strXmlPath XML 文件路径 * @param[in] callback 自定义控件的回调处理函数 * @return 无 */ static void FillBox(Box* pUserDefinedBox, const std::wstring& strXmlPath, CreateControlCallback callback = CreateControlCallback()); /** * @brief 使用构建过的缓存填充指定 Box，如果没有则重新构建 * @param[in] pUserDefinedBox 要填充的 box 指针 * @param[in] strXmlPath XML 文件路径 * @param[in] callback 自定义控件的回调处理函数 * @return 无 */ static void FillBoxWithCache(Box* pUserDefinedBox, const std::wstring& strXmlPath, CreateControlCallback callback = CreateControlCallback()); /** * @brief 自定义控件创建后的全局回调函数 * @param[in] strControlName 自定义控件名称 * @return 返回一个自定义控件的对象指针 */ static Control* CreateControl(const std::wstring& strControlName); /** * @brief 判断当前是否使用了 zip 压缩包 * @return 返回 true 表示使用了 zip 压缩包作为资源，false 为普通目录模式 */ static bool IsUseZip(); /** * @brief 打开一个内存压缩包资源 * @param[in] resource_name 资源名称，由 MAKEINTRESOURCE 宏生成 * @param[in] resource_type 资源类型，自定义导入的资源类型名称 * @param[in] password 压缩包密码 * @return 返回 true 打开成功，返回 false 为打开失败 */ static bool OpenResZip(LPCTSTR resource_name, LPCTSTR resource_type, const std::string& password); /** * @brief 打开一个本地文件压缩包资源 * @param[in] path 压缩包文件路径 * @param[in] password 压缩包密码 * @return 返回 true 打开成功，返回 false 为打开失败 */ static bool OpenResZip(const std::wstring& path, const std::string& password); /** * @brief 获取压缩包中的内容到内存 * @param[in] path 要获取的文件的路径 * @return 返回文件的内存地址 */ static HGLOBAL GetData(const std::wstring& path); /** * @brief 获取文件在压缩包中的位置 * @param[in] path 要获取的文件路径 * @return 返回在压缩包中的文件位置 */ static std::wstring GetZipFilePath(const std::wstring& path); private: /** * @brief 加载全局资源 * @return 无 */ static void LoadGlobalResource(); private: static std::unique_ptr m_renderFactory; class ImageCacheKeyCompare { public: // 这个比较函数不是比较字典序的，而是按照以下法则： // 首先比较，长度小的更小 // 再逆向比较，可以认为是逆向字典序 bool operator()(const std::wstring& key1, const std::wstring& key2) const; }; typedef std::map, ImageCacheKeyCompare> MapStringToImagePtr; static std::wstring m_pStrResourcePath; //全局的资源路径，换肤的时候修改这个变量 static std::vector m_aPreMessages; static std::map> m_builderMap; static CreateControlCallback m_createControlCallback; static MapStringToImagePtr m_mImageHash; static std::map m_mapTextColor; static std::map m_mGlobalClass; static std::map m_mCustomFonts; static std::wstring m_sDefaultFontId; static short m_H; static short m_S; static short m_L; static std::wstring m_strDefaultFontName; static std::wstring m_strDefaultDisabledColor; static std::wstring m_strDefaultFontColor; static DWORD m_dwDefaultLinkFontColor; static DWORD m_dwDefaultLinkHoverFontColor; static DWORD m_dwDefaultSelectedBkColor; }; } // namespace ui #endif // UI_CORE_WINDOWHELPER_H_