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

- **颜色**:`Color` 分量是 [0,1];整数用 `Color::FromArgb`。
- **尺寸/布局**:`SetWidth/Height` 是固定尺寸;`SetFill*` 是填满父轴;拉伸权值分配**剩余**空间(v1.17.0);图表默认权值 0,`SetFill*` 在父级有约束时生效、无约束时回退 `420×260`(v1.19.4)。
- **窗口最小尺寸**:含长文本/图表的窗口建议显式 `SetMinSize`,否则会被内容测量结果撑大。
- **重绘**:`RequestRepaint()` 只标脏、**不排帧**;不要试图在标脏处强制出帧(会持续重渲染卡顿)。`InvalidateLayout()` 冒泡,`InvalidateLayoutSelf()` 不冒泡(池化/虚拟 rebind 用)。
- **缓存**:默认开;每帧内容变化/实例极多的控件 `SetUseCache(false)`;释放整棵子树用 `ReleaseDeviceResourcesRecursive()`。
- **文本**:`SetTextFast` 不重绘(池化专用);`FontManager` 返回的 layout/format 共享只读,勿改;`GetFormat` 的共享 format 是 `ParagraphAlignment=CENTER`,多行自绘要自己设 `NEAR` 或走 `GetStyledLayout`。
- **信号**:`Fire` 快照遍历、可安全 disconnect;`Connection` 析构不断开;`DrawOverlay` 必须按窗口过滤;别用捕获自身 `shared_ptr` 的 lambda 连自己;`AddKeyHandler` 的 handler 是快照调用,移除不取消当前轮。
- **数据视图**:源行号 vs 可见序两套坐标;`SortItems` 重排并清多选,`SortView` 只改可见序;`parent` 是 `weak_ptr`;行背景用 `node->bgColor`;`SetFilter`/`SetViewComparator` 会保存 lambda;行高必须 >0。
- **多行编辑**:`AcceptsTab` 为真时 Tab 是缩进;富文本只读;换行宽度变化重建全部行 layout。
- **滚动条**:宿主用 `ShrunkWidthRatio` 预留槽位;空闲缩小是**惰性**的。
- **Drawer**:`SetContent` 是主内容、`SetPanel` 是抽屉面板;`SetPanelSize` 是外框且默认 16px padding 会扣内容;Permanent 下 `Close` 无效;Scrim 只在 Overlay+Modal 生效,`SetScrimOpacity(0)` 仍拦点击。
- **窗口周边**:`Window` 没有尺寸/DPI 变化信号;`StatusBar::AddPanel` 没有点击回调;任务栏 COM 失败静默,`FLASHW_CAPTION` 对自绘标题栏无效。
- **无障碍/调试**:角色决定暴露的 UIA Pattern;调试命令发送要带超时。
- **DSL(`ZufyUIDsl.h`,可选)**:`root()` 收任意 `Layout` 子类;`add()` 按容器真实接口分派(`GridLayout` 必须用 `.cell(row,col,child)` 或 `dsl::Cell(...)`);空元素(`nullptr` / 空 `Ref`)一律被忽略;`with()` 只接成员函数指针,多步逻辑用 `apply(lambda)`;`WindowApp::run()` 会 `Show()`(`Window::Create` 不显示窗口),隐藏启动用 `.hidden()`。
###block_red_end
第 22 章

易错点总表

按主题速查

易错点总表

  • 颜色:Color 分量是 [0,1];整数用 Color::FromArgb。
  • 尺寸/布局:SetWidth/Height 是固定尺寸;SetFill* 是填满父轴;拉伸权值分配剩余空间(v1.17.0);图表默认权值 0,SetFill* 在父级有约束时生效、无约束时回退 420×260(v1.19.4)。
  • 窗口最小尺寸:含长文本/图表的窗口建议显式 SetMinSize,否则会被内容测量结果撑大。
  • 重绘:RequestRepaint() 只标脏、不排帧;不要试图在标脏处强制出帧(会持续重渲染卡顿)。InvalidateLayout() 冒泡,InvalidateLayoutSelf() 不冒泡(池化/虚拟 rebind 用)。
  • 缓存:默认开;每帧内容变化/实例极多的控件 SetUseCache(false);释放整棵子树用 ReleaseDeviceResourcesRecursive()。
  • 文本:SetTextFast 不重绘(池化专用);FontManager 返回的 layout/format 共享只读,勿改;GetFormat 的共享 format 是 ParagraphAlignment=CENTER,多行自绘要自己设 NEAR 或走 GetStyledLayout。
  • 信号:Fire 快照遍历、可安全 disconnect;Connection 析构不断开;DrawOverlay 必须按窗口过滤;别用捕获自身 shared_ptr 的 lambda 连自己;AddKeyHandler 的 handler 是快照调用,移除不取消当前轮。
  • 数据视图:源行号 vs 可见序两套坐标;SortItems 重排并清多选,SortView 只改可见序;parent 是 weak_ptr;行背景用 node->bgColor;SetFilter/SetViewComparator 会保存 lambda;行高必须 >0。
  • 多行编辑:AcceptsTab 为真时 Tab 是缩进;富文本只读;换行宽度变化重建全部行 layout。
  • 滚动条:宿主用 ShrunkWidthRatio 预留槽位;空闲缩小是惰性的。
  • Drawer:SetContent 是主内容、SetPanel 是抽屉面板;SetPanelSize 是外框且默认 16px padding 会扣内容;Permanent 下 Close 无效;Scrim 只在 Overlay+Modal 生效,SetScrimOpacity(0) 仍拦点击。
  • 窗口周边:Window 没有尺寸/DPI 变化信号;StatusBar::AddPanel 没有点击回调;任务栏 COM 失败静默,FLASHW_CAPTION 对自绘标题栏无效。
  • 无障碍/调试:角色决定暴露的 UIA Pattern;调试命令发送要带超时。
  • DSL(ZufyUIDsl.h,可选):root() 收任意 Layout 子类;add() 按容器真实接口分派(GridLayout 必须用 .cell(row,col,child) 或 dsl::Cell(...));空元素(nullptr / 空 Ref)一律被忽略;with() 只接成员函数指针,多步逻辑用 apply(lambda);WindowApp::run() 会 Show()(Window::Create 不显示窗口),隐藏启动用 .hidden()。
↑