易错点总表
- 颜色:
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()。