# ZufyUI **Repository Path**: zhc9968/ZufyUI ## Basic Information - **Project Name**: ZufyUI - **Description**: 基于 Direct2D 的 C++ 原生 Win32 自绘 UI 框架,含布局、控件、信号槽与高 DPI 适配。有完整动画、IME兼容、UI扁平化。 - **Primary Language**: C/C++ - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 1 - **Created**: 2026-09-25 - **Last Updated**: 2026-11-20 ## 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://zhc9968.github.io/ZufyUI/docs/API.html) · [English](README.en.md) · MIT ![ZufyUI Demo](docs/images/demo-main.png) ## 快速开始 > 目标:**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