# ZufyUI API 参考 > 本文档覆盖 ZufyUI 框架的全部公开 API,**按“使用分类”组织**(不是按代码/头文件顺序)。 > 配套阅读:[项目说明与构建](https://github.com/zhc9968/ZufyUI/blob/master/README.md)。 > **阅读方式**:本文不是“签名清单”,而是按“它是什么 → 框架内部怎么处理 → 你需要注意什么”来写。 > 每个类先讲整体行为,再逐函数讲副作用、默认值与易混点。**没有读过源码也能据此正确使用。** > **两个贯穿全文的标记**: > - **`易错`**:真实踩过的坑 / 反直觉行为,优先看这些。 > - **`版本`**:该 API 或语义发生显著变化的版本(`新增`/`变更`/`废弃`)。当前发布为 **v1.29.1**。
# ZufyUI API 参考
本文档覆盖 ZufyUI 框架的全部公开 API,按“使用分类”组织(不是按代码/头文件顺序)。 配套阅读:项目说明与构建。
阅读方式:本文不是“签名清单”,而是按“它是什么 → 框架内部怎么处理 → 你需要注意什么”来写。 每个类先讲整体行为,再逐函数讲副作用、默认值与易混点。没有读过源码也能据此正确使用。
两个贯穿全文的标记: -
易错:真实踩过的坑 / 反直觉行为,优先看这些。 -版本:该 API 或语义发生显著变化的版本(新增/变更/废弃)。当前发布为 v1.29.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 章附录
默认值与信号索引