ZZufyUI文档首页DocumentationДокументацияDokumentationDocumentationDocumentación

正在准备文档Preparing your docsПодготовка документацииDokumentation wird geladenPréparation de la documentationPreparando la documentación

从这里开始 · 支持全文搜索

框架概览

轻量到几 MB,快到原生合成。 纯头文件、零第三方依赖的 C++20 Windows 自绘 UI 框架,直接构建在 Direct2D 1.1 + DirectComposition 之上。 - 没有 Qt 的打包包袱,没有 Electron 的内存税。 几个头文件,include 即用;应用工程不链

易错点

> 这份文件把散落在代码注释、HANDOFF.md、TODO.md 里的“坑”集中到一处。接手/使用前先扫一遍。 > 优先级:易错 = 违反必踩;注意 = 契约/限制,违反易出问题;约定 = 库的取向;不要 = 明确不做。 --- 1. 链式构造 DSL(ZufyUIDsl.h) | | 状态 |

参考总览

> 本文档覆盖 ZufyUI 框架的全部公开 API,按“使用分类”组织(不是按代码/头文件顺序)。 > 配套阅读:[项目说明与构建](https://github.com/zhc9968/ZufyUI/blob/master/README.md)。 > 阅读方式:本文不是“签名清单”,而是按“它是

约定

颜色与标记 - 红色块:易错——真实踩坑、反直觉行为、会崩溃/UAF/竞争的用法,优先看。 - 橙色块:注意——线程、生命周期、绘制顺序等契约;不一定是错误,但违反后容易出问题。 - 绿色块:推荐——推荐写法、所有权模型、最佳实践。 - 普通项目符号表示普通语义、默认值或版本变化,不代表没有风险。

快速开始

最小程序 cpp include "ZufyUI.h" include "ZufyUIWidgets.h" using namespace ZufyUI; int APIENTRY wWinMain(HINSTANCE, HINSTANCE, LPWSTR, int) { // Windows 子系

基础类型

Color cpp struct Color { float r, g, b, a; // 分量范围 [0,1],不是 0..255 Color(float r=0, float g=0, float b=0, float a=1.0f); static Color FromArgb(uint8t

事件与信号

何时用信号 - 控件对外通知(点击、选中、值变化)用内置 ZSignal。 - 自定义控件对外事件:自己声明 ZSignal 成员并 Fire。 ConnectionThread cpp enum class ConnectionThread { CurrentThread, NewThread,

语言

AI 协作 / v1.29.1

AI 阅读入口

从功能地图进入模块契约与实现细节。

下载 Markdown

ZufyUI 是 C++20、Win32、Direct2D / DirectComposition 构建的头文件 UI 框架。本文件是导航,不替代源码、API 或仓库协作规则。先读取 AGENTS.md,再按任务进入下面的模块;不要一次加载全部实现。

版本与权威来源

  • 当前版本以 ZufyUIVersion.h 的 ZufyUI_VERSION_STRING 为准;站点构建自动读取它。
  • 中文 API / English API:签名、默认值和使用约定。
  • README:运行第一个窗口;CHANGELOG:版本变化。
  • 签名与说明冲突时检查对应头文件,修正双语 API 并运行一致性检查,不凭名称猜测接口。

功能地图

任务 下一步 实现入口
窗口、生命周期、信号、布局、渲染 核心索引 ZufyUI.h、ZufyUI/detail/
基础控件、数据视图、图表、主题样式、DSL 控件索引 ZufyUIWidgets.h、ZDataViewer.h、ZufyUICharts.h、ZufyUIDsl.h
运行状态、JSON 调试、MCP、UIA 调试索引 tools/zufyui_debug.py、ZufyUIDebugger/
构建、回归、文档生成、提交规则 协作索引 tools/、tests/、docs-site/

推荐读取顺序

  1. 本入口 → 模块总索引 → 对应叶子文档。
  2. 查询叶子文档指向的 API 章节与实现。只展开当前任务需要的部分。
  3. 修改前检查 易错点,修改后运行相应测试。

文档站在构建时生成 /llms.txt(索引)、/llms-full.txt(完整文档快照)和 /raw/(原始 Markdown)。自动构建更新这些快照;模块约定的语义仍需随 API 改动维护。

查看源文件LLM.MD