面向 AI 智能体:本页的「阅读辅助」区块内含有与正文完全一致的原始 Markdown 源码,已去除 HTML 标签与动画特效。建议 AI 直接读取该区块,以更低的噪声快速理解内容。
# ZufyUI API 参考

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

> **阅读方式**:本文不是“签名清单”,而是按“它是什么 → 框架内部怎么处理 → 你需要注意什么”来写。
> 每个类先讲整体行为,再逐函数讲副作用、默认值与易混点。**没有读过源码也能据此正确使用。**

> **两个贯穿全文的标记**:
> - **`易错`**:真实踩过的坑 / 反直觉行为,优先看这些。
> - **`版本`**:该 API 或语义发生显著变化的版本(`新增`/`变更`/`废弃`)。当前发布为 **v1.29.1**。
打开本文档的完整源文件:查看完整 Markdown

# ZufyUI API 参考

本文档覆盖 ZufyUI 框架的全部公开 API,按“使用分类”组织(不是按代码/头文件顺序)。 配套阅读:项目说明与构建。

阅读方式:本文不是“签名清单”,而是按“它是什么 → 框架内部怎么处理 → 你需要注意什么”来写。 每个类先讲整体行为,再逐函数讲副作用、默认值与易混点。没有读过源码也能据此正确使用。

两个贯穿全文的标记: - 易错:真实踩过的坑 / 反直觉行为,优先看这些。 - 版本:该 API 或语义发生显著变化的版本(新增/变更/废弃)。当前发布为 v1.29.1。

第 1 章

约定

命名空间、单位、生命周期、版本与易错标注约定

第 2 章

快速开始

最小程序、组件结构与阅读路径

第 3 章

基础类型

Color、Rect、Thickness、Size

第 4 章

事件与信号

ZSignal、Connection、跨线程

第 5 章

字体与图标

FontSpec、FontManager、Icon

第 6 章

元素基类

UIElement(布局属性、缓存、事件、无障碍、调试)

第 7 章

布局系统

Layout、ColumnBox、RowBox、GridLayout、Card、Page、PageHost

第 8 章

窗口

Window(创建、显示、背景、标题栏、任务栏、DPI、帧率)

第 9 章

基础控件

Label、Button、TextBox、TextEdit、ComboBox

第 10 章

选择与输入

CheckBox、RadioButton、RadioGroup、ToggleSwitch、Slider、NumberBox

第 11 章

进度

ProgressBar、ProgressRing

第 12 章

容器与滚动

ScrollViewer、ScrollBar、SplitView、Drawer、TabView

第 13 章

菜单与弹窗

Menu、MenuItem、MenuWindow、MessageBox

第 14 章

数据视图

ListView、TableView、TreeView、TreeNode(虚拟化、隐藏/筛选/可见序)

第 15 章

图表

ChartBase、BarChart、LineChart、PieChart(v1.18.0)

第 16 章

窗口周边

图像、托盘、系统对话框、应用注册

第 17 章

拖放与卡片组件

Drag & Drop、Expander、SettingsList(v1.19.0)

第 18 章

主题系统

Theme(v1.19.0+)

第 19 章

DSL

链式构造(ZufyUIDsl.h,v1.19.4;v1.20.0 扩充)

第 20 章

无障碍与调试通道

UIA + SetDebugEnabled(v1.17.0)

第 21 章

版本变化摘录

v1.15.0 → v1.29.1

第 22 章

易错点总表

按主题速查

第 23 章

附录

默认值与信号索引

↑