# ZufyUI **Repository Path**: whrct22/ZufyUI ## Basic Information - **Project Name**: ZufyUI - **Description**: 基于 Direct2D 的 C++20 原生 Win32 自绘 UI 框架,支持布局、控件、信号槽、动画、高 DPI 和 IME,提供 Fluent 风格界面、主题样式系统及 JSON/MCP 调试工具。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-11-17 - **Last Updated**: 2026-11-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # ZufyUI **轻量到几 MB,快到原生合成。** 纯头文件、零第三方依赖的 C++20 Windows 自绘 UI 框架,直接构建在 Direct2D 1.1 + DirectComposition 之上。 - **没有 Qt 的打包包袱,没有 Electron 的内存税。** 几个头文件,`#include` 即用;应用工程不链接任何第三方库。 - **WinUI 3 / Fluent Design 风格。** 亚克力 / 云母、圆角、层次阴影、强调色与动效,接近 Windows 11 原生观感。 - **能嵌原生内容。** `HwndView` 把 WebView2、摄像头、第三方控件甚至进程外 HWND 嵌进布局(跨进程、区域裁剪、随窗口移动)。 **👉 [下载 Release Demo](https://github.com/zhc9968/ZufyUI/releases)** · [Gitee Releases](https://gitee.com/zhc9968/ZufyUI/releases) · [在线 API](https://docs.aichaln.one/zh/api/overview/) · [English](README.en.md) · MIT [![ZufyUI:原生界面,轻量构建;当前 Gallery 的真实运行界面](docs/images/promo-overview.zh.png)](docs/images/README.md) [查看浅色原图](docs/images/demo-main.png) · [深色原图](docs/images/gallery-dark.png) · [更多实拍与素材说明](docs/images/README.md) ## 快速开始 > 目标:**10 分钟内跑出第一个窗口**,并清楚接下来该看哪一章。按下面的步骤走即可。 **第 0 步:准备(纯头文件,零构建配置)** - 把 `ZufyUI.h`、`ZufyUIWidgets.h`、`ZDataViewer.h`、`ZufyUICharts.h`、`ZufyUIWindowTool.h`、`ZufyUIDragDrop.h` 所在目录加入**包含路径**即可;**不需要编译任何 .cpp**,也不依赖第三方库。 - 依赖的系统库全部由库内 `#pragma comment(lib, ...)` 自动链接(完整清单见「环境要求」)。 - GUI 程序入口用 **`wWinMain` + `/SUBSYSTEM:WINDOWS`**。 - 环境对 BOM / 中文源码不友好时,先运行 [纯 ASCII 导出](#纯-ascii-导出),用 `dist/ascii` 里的头文件。 - **⚠ 入口易错**:若坚持写 `int main()`,必须把子系统设成 `/SUBSYSTEM:CONSOLE`,或加 `#pragma comment(linker, "/SUBSYSTEM:WINDOWS /ENTRY:mainCRTStartup")`,否则链接器找不到入口。 **第 1 步:最小窗口 + 一个按钮 + 一个开关** ```cpp #include "ZufyUIWidgets.h" using namespace ZufyUI; int WINAPI wWinMain(HINSTANCE, HINSTANCE, LPWSTR, int) { Window win; if (!win.Create(1000, 700, L"ZufyUI Demo")) return 1; auto root = win.GetRootColumnBox(); root->SetSpacing(10); auto row = std::make_shared(); row->SetSpacing(10); auto btn = std::make_shared