# 控件选择与 DSL

[控件索引](LLM.MD) · [API](../../src/API.md)

## 模块入口

| 场景 | 入口 |
| --- | --- |
| 按钮、文本、选择、输入、滚动、菜单 | [ZufyUIWidgets.h](../../../ZufyUIWidgets.h) |
| ListView、TableView、TreeView | [ZDataViewer.h](../../../ZDataViewer.h) |
| BarChart、LineChart、PieChart | [ZufyUICharts.h](../../../ZufyUICharts.h) |
| 原生 HWND 嵌入 | [ZufyUIHwndView.h](../../../ZufyUIHwndView.h) |
| 图片、拖放、窗口工具 | `ZufyUIImages.h`、`ZufyUIDragDrop.h`、`ZufyUIWindowTool.h` |
| 链式构建 | [ZufyUIDsl.h](../../../ZufyUIDsl.h) |

## 数据视图

按项/按行的元信息要绑定对象，或在增删和排序时重映射。不要将可失效下标或裸指针当永久标识。验证虚拟化、过滤、隐藏与可见顺序的交互。

## DSL

短工厂使用 `Z` 前缀，如 `ZBtn`、`ZLbl`、`ZPage`。`.with(&T::Method, args...)` 适合无默认参数、无重载歧义且不接收初始化列表的方法。存在重载、初始化列表或多步逻辑时使用 `.apply([](T& x) { ... })`。

新增接口保持调用侧一致；具体签名从头文件或双语 API 复制，不凭类似控件推测。
