完整历史与逐项说明。README 只保留简略版本历史。
当前版本:1.29.1(以
ZufyUI.h的ZufyUI_VERSION_STRING为准;本日志与 API 文档顶部版本号均以该宏为单一来源)。
2026-11-20 — PageHost 动画与指针取消修复(v1.29.1)
- PageHost 反向过渡:EaseOut 反向进度改回
1 - cbrt(EasedProgress()),修复反向瞬间跳动。 - PageHost 命中测试:动画期间先按页面的
GetChildRenderTransform反向平移坐标再命中,悬停/点击/右键不再落到未移动的旧位置。 - PageHost 删除页:
RemovePage在动画中会调整/取消fromIndex_、toIndex_,不留下旧索引。 - OnPointerCancel 接线:
WM_CANCELMODE/WM_CAPTURECHANGED现在会取消pressedElement_/mouseCaptureElement_并清理捕获;OLE 拖出期间跳过,避免再次破坏文件拖出。 - 显示事件:
Opening/Opened对菜单等WantDwmChrome()==false的窗口也会触发,PresentationState正确进入Open。 - 回归测试:新增 PageHost 动画反向、动画中命中、动画中删除页的 headless 自检;
TODO.md基线更新到1.29.1。 - 验证:x64 / x86 Release + ZufyUIDebugger 构建与全量自检通过。
2026-11-20 — 指针/焦点反馈、窗口过渡与文档修复(v1.29.0)
- 指针 / 焦点 / 输入反馈:新增
SetPointerCursors/GetPointerCursorAt/OnPointerCancel;完善 TextBox 焦点背景/边框、光标颜色/粗细、指示条和密码眼睛;ComboBox 支持键盘展开与上下选择;Slider 松手补齐最终坐标;ListView/TableView/TreeView、ScrollBar、Expander、SettingsList、NumberBox 补光标与取消状态。 - 布局 / 字体修正:Expander、SettingsList、ChartBase/PieChart 继承有效字体;MenuBar 增加分数字形宽度余量;Button
FillWidthMeasure 修正;ListView 首次 Arrange 前的EnsureVisible延迟处理;标题栏激活标题色修正。 - 窗口过渡:新增
PresentationState、SetTransitionDurations、GetPresentationState、GetPresentationProgress、IsTransitionActive和DefaultWindowSetup;普通窗口支持 DComp 淡入淡出,默认时长仍为 0,菜单自身的透明度动画不受影响。 - 菜单 / PageHost:菜单点击回调改用
QueueToUIThread,避免在 WndProc 栈上析构菜单;PageHost 支持切换中途反向导航,并修正 EaseOut 反向进度计算。 - 文档:修复第 8 章标题乱码、配套 README 链接和 4 处 API 文档乱码,重新生成中英文 API 文档。
- 验证:x64 / x86 Release + ZufyUIDebugger 构建与全量自检通过。
2026-11-19 — 非阻塞 Present、高刷新帧节拍、私有字体与 UIA 生命周期(v1.28.0)
- 非阻塞 Present:新增
Window::SetNonBlockingPresent(opt-in)。开启后Present1(0, DXGI_PRESENT_DO_NOT_WAIT);队列忙时由现有定时器/帧时钟重试最新帧,不阻塞 UI 线程、不空转。 - 高刷新帧节拍:新增
SetDisplayFramePacing/GetDisplayRefreshHz与ZufyUIFrameClock.h。后台线程只做定时器 +PostMessage,布局、绘制、Present 仍在 UI 线程;默认关,菜单默认开。 - 菜单同步:
MenuWindowBase默认同步非阻塞 Present 与帧节拍;UseNonBlockingPresent/UseFramePacing是静态退避开关;隐藏、关闭、WM_DESTROY与析构都会Stop()帧时钟。 - 私有字体:
FontManager::SetAppFontCollection;必须在任何 format/layout 之前安装,内部持有集合引用;菜单直接CreateTextFormat路径仍用系统字体。 - UIA 生命周期:根 provider 与子 provider 统一
DetachElement + UiaDisconnectProvider;WM_DESTROY调用UiaReturnRawElementProvider(hwnd,0,0,nullptr);UiaDisconnectProvider移出UiaMutex锁外;SetRootLayout/SetAccessibilityEnabled(false)也统一回收。 - Demo:“窗口属性”页新增非阻塞 Present / 高刷新帧节拍开关;“弹窗行为”页覆盖位置、跟随、边界、关闭策略与事件日志。
- 验证:x64
7408/ x867425自检通过。
2026-11-19 — 弹窗窗口行为(v1.27.3)
- 窗口位置:新增
Window::Placement(系统默认 / 居中于 owner / 居中于屏幕),以及CenterOnOwner/CenterOnScreen。 - owner 跟随与移动边界:新增
SetFollowOwner和MoveBounds(无限制 / owner 客户区 / 显示器工作区)。owner 移动时 owned 子窗口跟随并裁剪。 - 关闭策略:新增
CloseReason、RequestClose、ForceClose、Opening/Opened/CloseRequested/CloseAccepted/CloseCancelled。支持禁用关闭、Esc 关闭、关闭拦截和强制关闭。 - 标题栏联动:自定义标题栏的关闭按钮使用
RequestClose(Caption);BehaviorChanged同步 owner-client 下的最大化不可用状态。 - 弹窗首帧:
RenderNowSync在首次Show时先推进布局并合成帧,减少弹窗首次显示空白。 - 知识产权:弹窗行为适配自 whrct22 的 ZufyUI 分支(MIT,commit
33c9d7e),详见 THIRD_PARTY_NOTICES.md。 - 验证:x64/x86 Release + ZufyUIDebugger 构建通过,自检通过。
2026-11-19 — Fluent 控件展厅与结构化调试(v1.28.0)
-
发行 Demo:新增可直接运行的 x64
demo.exe,重做首页、组件搜索、图标导航和真实控件预览;保留 26 个演示页面。统一浅深主题,标题栏与状态栏共享整窗 Acrylic 背景,页面过渡缩短为 180ms。 -
图标与字体:重新绘制应用标识并生成多分辨率 ICO;将 MiSans VF 常规字重固定后按全部源码文案子集化,嵌入 EXE,开放文本使用系统字形回退。
-
交互修复:修复 ListView 首次布局前选中造成首行滚走;修复填满宽度的富内容 Button 仍按固定宽度测量;为 MenuBar 字形小数宽度保留像素舍入空间。新增对应布局回归断言。
-
版本资源:库版本与 EXE 文件属性共同读取
ZufyUIVersion.h,同步导出和文档构建脚本。 -
实机验证修复:滑块在鼠标松开时提交最终坐标,避免最后一条移动消息合并后留下旧值;活动标题文字随主题更新;修正展厅输入框和进度条切换深色后的配色。发布脚本核验 EXE 内嵌字体摘要与版本。
-
真实字重:内嵌 MiSans 常规和半粗两个真实静态字重,清除与静态字重冲突的可变字体 STAT 元数据,消除标题的模拟粗体;六个组件入口统一常规体。设置列表、折叠标题和图表默认字体改为继承应用字体。
-
累计纳入:保持 header-only 的核心/控件模块拆分;可选统一样式配置、运行中样式编辑/撤销;JSON CLI 与 18 个 MCP 调试工具,窗口身份校验和结构化错误返回。
-
复合控件反馈:密码眼睛改为缓存的等比曲线路径;
GetPointerCursorAt按实际操作区解析指针,区分文字与显隐按钮。补齐数字框增减/重置、滑条、独立滚动条和列表/表格/树内绘滚动条;关闭 IME 的数字输入仍显示文本指针。取消捕获时清理拖动状态,并增加区域、禁用、取消及绘制资源回归检查。 -
可读性复查:设置卡片整行与折叠标题使用动作指针;输入与滚动页将高级输入及八个操作按钮分成两列,完整显示动作名称。环境组合页初始化不再覆盖启动时的浅深主题选项。
2026-11-14 — 稳定性、控件交互与全页面切换补丁(v1.27.2)
- 窗口裸指针/UIA 崩溃:新增
Window::ForgetElement,统一清焦点、按下、捕获、悬停、tooltip、待重绘与 UIA provider 缓存;UIElement::SetParent在脱离窗口时提前注销,~UIElement继续兜底。UIA provider 释放前调用UiaDisconnectProvider,修复ClearChildren()/成员操作后的 AV 与 CFGFAST_FAIL_GUARD_ICALL_CHECK_FAILURE。 - TreeView 列宽:新增
SetStretchLastColumn(bool)/GetStretchLastColumn()(默认开);内容总宽小于视口时把剩余宽度补给最后一列,修复单列树中文标签被 40px 最小列宽截成...。 - R7 选择一致性:ListView
GetSelectedIndices现在包含selectedIndex_;SelectAll/切换/Shift/框选都会发出多选信号;清空 API 会清理当前状态。TableView 新增SelectAll,GetSelected*包含当前单元格,清空/框选也会发信号。TreeView 多选模式下SetSelectedNode改为替换而不是累积。 - ViewCore 脚手架:新增
viewcore::ScrollAxis/ScrollViewport、RecyclePool<T>和FetchFlow<Result>;ListView 使用ScrollAxis管理垂直滚动状态,并支持SetItemProvider(count, fetch)/SetAsyncItemProvider(count, fetcher)虚拟文本;demo 用 20 万条伪随机数据做异步压力。 - SplitView:左右/上下分栏的展开按钮按分隔条方向自适应;空间不足时按钮仍显示但灰化、不可悬停/点击;新增
SwitchToFirst/Second/Pane全页面滑动过渡(复用 PageHost 风格缓动),即使两侧最小尺寸放不下也完整播放,结束后提交折叠状态并发出ActivePaneChanged。 - 异步任务:新增
RunAsync<T>/AsyncTask/AsyncCancelToken/AsyncProgress/AsyncOwner;后台执行、协作取消、合并 UI 进度、UI 线程上的完成/失败/取消回调,以及弱 owner 过期后丢弃回调;补充基础、异常、取消、生命周期、1000 次取消/完成竞态和 1000 任务随机压力自检。 - 图像 / 窗口事件:
Image::FromHBITMAP读取 32bpp DIB 像素并保留 alpha(可选预乘标志);新增Window::SizeChanged/DpiChanged;补多选和 HBITMAP alpha 自检。 - SplitView 折叠/拖动:统一
ClampFirstLen,修复最小宽度冲突、反向拖动与首尾空间不足展开;新增不足空间默认侧/自动折叠配置。 - TrayIcon:同时处理 NOTIFYICON_VERSION_4 与 v3 的
WM_LBUTTONUP/WM_RBUTTONUP/WM_LBUTTONDBLCLK回退,修复托盘左键、右键、悬停无响应;新增SetClickImmediate。 - Drawer:关闭完成时递归失效内容区布局并重绘,修复 overlay 外点击关闭后内容不刷新。
- Card:内容布局测量/摆放纳入子布局 margin,修复 Card → ColumnBox 首尾 margin 被忽略。
- TextBox 密码框:密码模式右侧增加矢量眼睛按钮,默认隐藏,点击切换明文/密文;新增
TogglePasswordReveal、SetPasswordRevealButtonVisible等控制接口。 - MessageBox:先按内容计算尺寸并
SetSize,再禁用缩放,避免WM_GETMINMAXINFO把高度截断导致底部按钮被裁;测量宽度扣除 root margin。 - 验证:x64 Release + ZufyUIDebugger 构建通过;297 项自检通过。
2026-10-31 — 菜单/标题栏/resize 修复与独立渲染线程停用(v1.27.1)
- 独立渲染线程:停用并清理实验性
ZUFYUI_RENDER_THREAD路径,保留稳定的单线程渲染与 VBLANK 帧同步代码;README/API 不再公开该实验特性。 - 右键菜单:非 DWM chrome 弹出层跳过 DWM frame/圆角处理,设置为不圆角、无 DWM 边框,修复菜单周围多余边框。
- 顶部菜单栏:菜单关闭时同时清理
openIndex_与hoverIndex_,避免菜单栏残留半截 hover/打开高亮。 - 标题栏:
AdvanceFrame改用实际IsVisible()判断自定义标题栏;SetTitleBarVisible(false)立即清标题栏高度并重新布局,修复隐藏标题栏或切回原生标题栏后菜单仍被下压。 - resize:
WM_SIZE调整交换链后同步提交一帧,拖拽期间Present1不等 vblank,避免布局已按新尺寸更新但画面仍是旧帧/透明。 - 验证:x64 Release + ZufyUIDebugger 构建通过;280 项自检通过。
2026-10-29 — Win10 背景/边框、Snap、渲染驱动与 API 收敛(v1.27.0)
- Windows 10 Acrylic:在创建
HostBackdropBrush前启用ACCENT_ENABLE_HOSTBACKDROP,保留自定义模糊/饱和度/tint/噪点链;Win10 不再写 Win11 专属 DWM 属性,避免灰色半透明和边框阴影丢失。 - 自定义边框 / Snap:Win10/Win11 都保留
DwmExtendFrameIntoClientArea({1,1,1,1});WM_SIZE/WM_WINDOWPOSCHANGED/ 背景重载后重新挂 frame 状态,修复 Win11 Snap 丢边框/阴影。 - 标题栏:Win10 三件套字体按
Segoe MDL2 Assets回退;最大化/还原按钮在系统 Snap、双击标题栏、Win+Up 等路径后主动刷新;拖动/缩放期间暂停 UI 动画更新,优先保证低性能设备跟手。 - 渲染驱动:新增
RenderDriver、SetRenderDriver()、GetActiveRenderDriver()、GetRenderDeviceName();Auto硬件优先回退 WARP,demo 支持--warp/--gpu和首页底部重启切换,状态栏显示实际驱动/适配器。WARP 只改变应用内容渲染,DWM/Compositor 仍可能使用 GPU。 - 破坏性 API 收敛:删除公开
WindowCorner、SetWindowCorner()、GetWindowCorner()和 DSLcorner();Win10 保持直角,Win11 跟随 DWM,自定义圆角由用户自行调用 Win32 DWM API 并承担风险。 - 验证:Win10/Win11 普通窗口、Snap 1/2、1/4、最大化/还原;x64 Release 构建通过,280 项自检通过。
2026-10-27 — 布局测量契约、UIA 生命周期修复、控件细化(v1.26.0)
- 布局 · 显式尺寸契约:
GridLayout的显式宽高现在同时作为 cell 测量范围,不再出现“对外返回 260、内部按 274+ 排”的溢出;RowBox/ColumnBox在有限主轴下给 Fill 子元素分配剩余空间;Card/Page/ScrollViewer无内容时也尊重显式尺寸;Button即使关闭 autoSize 也测量内容;Label的显式宽度参与 Wrap 折行;TabView的页签 Label 在 Measure 量宽、Arrange/Update 摆放;ScrollViewer不在 Arrange 重测内容。 - UIA · CFG 崩溃修复:minidump 确认为
c0000409+Subcode 0xA FAST_FAIL_GUARD_ICALL_CHECK_FAILURE,不是 Stack Cookie/TDR。UiaContexts改为共享 context,UIA context/provider 缓存统一递归锁;provider 不再保存裸 context;ReleaseAccessibility/ForgetAccessibleElement与回调串行化;通知路径保证 provider 存活。用 100 轮 UIA 树遍历 + 300 次ElementFromPoint压力查询验证。 - Expander:初始折叠也测量一次 content;展开状态内容始终在
childrenView_,折叠再展开不再丢失;动画不再每帧SetHeight/重复失效;内容裁剪至少留 4px bleed;修复首次展开文字偏右/下拉控件被裁。 - ToggleSwitch:点击改为松开时切换;按住左右拖动使 knob 跟随鼠标,按拖动进度切换;鼠标捕获;默认动画时长 0.18s。
- Slider:新增
GetDisplayValue();普通拖动立即跟手,点击轨道和吸附才缓动到目标;保留 UIA RangeValue。 - Demo:布局压力测试页修复 Grid 高度/输入行宽度/标签折行;新增“全控件总览”页;HwndView 页内浮窗默认隐藏并可开关。
- 文档:API 中英文同步(Grid/Expander/ToggleSwitch/Slider、UIA);README 版本历史与功能说明;AGENTS 增加布局/UIA/动画/崩溃码事故教训。
- 验证:x64 Release 构建通过;ZufyUI 自检 280 项通过;UIA 压力查询通过。
2026-10-25 — Drawer 侧边抽屉、临时键处理器、信号测试(v1.25.0)
- 新增 ·
Drawer侧边抽屉:左/右/上/下四方向 × Overlay / Push / Permanent 三模式。Overlay 使用圆角遮罩;Push 让内容让位;Permanent 常驻、无动画/遮罩、Close无效。面板支持圆角、边框、真实外侧阴影(先画阴影,再用不透明面板背景盖住内层,边框最后绘制)。 - 新增 ·
Window::AddKeyHandler / RemoveKeyHandler:临时窗口级键处理器,在OnWindowKeyDown之后、焦点元素之前调用;Drawer 打开时处理 Esc,关闭/detach/析构时移除。 - 新增 · Drawer Demo:下拉选择左/右/上/下与模式、打开/关闭、面板顶部 X、搜索/类别/只看活动/结果计数/筛选列表;内容含 BarChart、Slider、Toggle、CheckBox、ListView。
- 改进 ·
ScrollViewer出血:内容裁剪出血从固定 1px 改为跟随内容GetBleed()(默认 4px),避免抽屉内控件边框/阴影被裁掉。 - 工程 · 测试改名:
tests/dsl_tests.cpp→tests/zufyui_tests.cpp,tools/run_dsl_tests.ps1→tools/run_tests.ps1。 - 测试:新增信号重入/槽异常/
NewThread弱引用保活/UIThread取消、Drawer 布局/动画/遮罩/Push/Permanent/上下面;ZufyUI 自检 213 项。 - Demo 默认背景:启动
Show()后再次应用 Acrylic,避免首次 DWM 应用不生效。 - 验证:x64 Debug/Release、x86 Release 构建通过;自检 213 项通过。
2026-10-25 — 信号生命周期、接收者上下文、ConnectWeak(v1.24.0)
- 破坏性 ·
ZSignal非移动:删除ZSignal的移动构造/赋值;信号作为控件/窗口成员使用,不要放进可移动容器。旧代码若移动ZSignal会编译失败。 - 破坏性 · 成员函数指针连接:
elem->Connect(sig, &Class::Method)不再支持;改用Connect(elem, sig, &Class::Method)(编译期检查)或ConnectWeak(elem, sig, &Class::Method)。 - 破坏性 ·
Connection语义:disconnect()现在会逻辑取消已排队的UIThread/NewThread任务;不会中断已经执行中的槽。 - 修复 · 信号存活竞争:
ConnectionState::alive改为原子;disconnect在状态锁内执行内部移除回调,信号析构先kill()再释放;修复alive数据竞争和 check-then-call UAF。 - 修复 · 队列任务:
UIThread/NewThread任务捕获连接状态,执行前检查存活;接收者析构或手动断开后不再执行。 - 新增 · 接收者上下文:
ConnectionOwner基类;UIElement/Window继承它。elem->Connect(...)、自由Connect(elem, ...)、sig.connect(elem, ...)的自动断开跟随接收者,而不是信号拥有者。 - 新增 ·
ConnectWeak:弱引用接收者,槽第一个参数为T*/T&或成员函数指针;槽执行期间保活,对象已销毁则跳过。适用于NewThread或无法保证生命周期的场景。 - 改进:
Window的ReloadAcrylic/ThemeChanged/ThemeReapply三条全局连接改走Window::ConnectionGroup;删除手工Connection成员。ConnectionGroup::size()只统计存活连接,并定期清理已断开弱引用。 - 范围:
Menu/MenuItem/Timer仍使用signal.connect,不自动断开。 - 测试:ZufyUI 自检 140 → 175 项;新增接收者析构断开、自由
Connect、ConnectWeak、Connection拷贝/移动、信号先析构、重入、槽异常、NewThread弱引用保活、UIThread取消等回归。 - 验证:x64 Debug/Release、x86 Debug 构建通过;DSL 175 项通过。x86 Release 本轮未重跑。
2026-10-23 — Button 富文本/下拉、SetBackdrop 修复、ListView 除零(v1.23.3)
- 新增 · Button 富文本 / 自定义内容:内部
Label现在是真正的子元素,GetLabel()->AddChild(...)会正常布局/合成/绘制;新增SetContent(shared_ptr<UIElement>)/ClearContent(),可整体替换按钮内容。 - 新增 · Button 下拉 2×2:
SetDropWriteBack(bool)×SetDropOpenOnClick(bool)。按钮点击始终触发Clicked;开菜单时先回调再弹菜单。菜单为单选(上次选中项有标记),选中触发DropSelected(index),可GetDropSelectedIndex/GetDropSelectedText读取;SetDropItems建文字列表,SetDropMenu接自定义菜单,ShowDropMenu()可在DropOpenOnClick=false时手动打开。菜单只在按钮下方弹出,不弹 MessageBox。 - 修复(下拉菜单位置):
GetDpiScale()返回 96/144(不是 1.0/1.5);旧乘法会把菜单送到屏幕右下角。除以 96 后菜单会落在按钮下方,demo 的 split 点击也不再弹 MessageBox。 - 修复 ·
SetBackdrop:未显式设置 tint 时,SetBackdrop(Acrylic/Mica)不再使用不透明白色叠加层(旧默认backdropFollowAlpha_=0xFF会盖住系统材质);None仍保持默认不透明白;显式 tint(含 alpha)保持不变。新增GetBackdropColor()便于诊断。 - 修复 ·
ListView:SetItemHeight夹到 ≥1px;Draw/ 命中测试补行高 >0 防御,避免SetItemHeight(0)的浮点除零与int转换 UB。 - 文档/清理:
HwndView注释补跨进程SetParent的输入队列/消息阻止/间歇不稳定风险;删除WM_ACTIVATE冗余判断;ZDataViewer.h显式包含<cstring>;移除 demo 空ScrollChanged回调。 - demo:按钮页新增富文本按钮与 split button 示例。
2026-10-22 — Debug 构建补 /bigobj(v1.23.2)
- 构建:
ZufyUI.vcxproj/ZufyUIDebugger.vcxproj的 Debug|Win32 与 Debug|x64 补/bigobj(Release 已有)。全量 Debug 构建此前会在ZufyUI.cpp/ZufyUIDebugger.cpp报C1128: 节数超过对象文件格式限制。 - 验证:Release / Debug × x64 / x86 的 demo + Debugger + ZufyUI 自检全部通过。
- 文档:README / AGENTS / API 补充“纯 ASCII 导出”与编码要求;
dist/ascii已加入.gitignore,不会提交。
2026-10-22 — PageHost 页面测量 + 文档 / 工程整理(v1.23.1)
- 修复(布局 / 命中):
PageHost此前只Arrange页面、从不Measure页面,而Page::Arrange仅在“尺寸变化”时补测。页面内元素由隐藏变为可见(典型:选择下拉后SetVisible(true)的Expander卡片)时,脏的 measure 传不到页面 → 新显示元素的desiredSize/arrangedRect为 0 → 画面能画出来却没有边框、HitTest命中失败,必须手动改变一次窗口大小才恢复。现PageHost::MeasureOverride测量所有页面;未变脏的页面命中Measure缓存,不增加重复测量。 - 文档:README 首屏改为“定位 + 差异点 + Release + 截图 + 单行实验提示”;完整功能总览折叠;新增 Issue/PR 模板;文档源移至
docs/src/并新增docs/README.md;中英文首屏对齐。 - 工程:
ZufyUIDebugger收入本仓库并加入解决方案;tools/build.ps1/run_tests.ps1通过vswhere自动定位 VS(不再写死路径),并修正 x86→Win32 输出路径;新增tools/export_ascii.py(纯 ASCII 分发,无 BOM)、tools/build_docs.py(ZufyUI 专用文档包装)、tools/make_icon.py(图标生成:docs/icon.*+ 应用图标ZufyUI.ico/small.ico)。 - 文档工具:通用
md2html移除 ZufyUI 专用版本探测,改为--var KEY=VALUE;新增--iconfavicon;ZufyUI 的版本注入/图标改由tools/build_docs.py负责。 - 仓库卫生:
TODO.md不再随仓库发布(已移出索引并加入.gitignore);dist/构建产物忽略。
2026-10-13 — 原生窗口宿主、外部视觉挂载、浮窗同步/性能、NumberBox 错误态、数据视图填充(v1.23.0)
- 新增:
ZufyUIHwndView.h(HwndView)——把 WebView2 HWND controller / 摄像头 / 第三方控件 / 进程外窗口嵌进布局。宿主为顶层 owned 弹窗,外部 HWND 以WS_CHILD嵌入(可跨进程);移动宿主时子窗口由系统一起走;裁剪 = 宿主客户区 +SetWindowRgn(元素矩形 ∩ 主窗口 ∩ 祖先GetClipRect)。 - 新增:
Window::CreateExternalVisual / SetExternalVisualBounds / RemoveExternalVisual(WinRTContainerVisual挂到根视觉,供 WebView2 CompositionController / 视频);Window::AddOverlaySync / RemoveOverlaySync / SyncOverlays(浮窗统一同步)。 - 性能:浮窗同步改为窗口级单点(
WM_MOVE/WM_SIZE/WM_DPICHANGED即时 + 共享 16ms 兜底),去掉每实例定时器;缓存 DPI/客户区;跳过冗余SetWindowPos、按变化带SWP_NOSIZE/NOMOVE;demo 全色图缓存 DIB。 - 修复(NumberBox):合法数值清除空文本错误态;
ResetToDefault通知后强制清错误;步进/清除按钮按下即触发(不再二次判定矩形)。 - 修复(数据视图):
ListView/TableView/TreeView的MeasureOverride认SetFillWidth/SetFillHeight。 - demo:新增「原生HWND」页(GDI 全色图 + 多布局 + 进程外
--outproc窗口托管)。
2026-10-13 — Tier 0 修复:布局溢出/对齐、IME、无障碍、外观/工程(v1.22.1)
- 修复(布局):
RowBox/ColumnBox里子元素base未夹到 min/max → 带SetMinWidth/Height的子元素把多余空间错误分给拉伸兄弟、整行/列溢出(滑条超出卡片就是这个)。现base先clamp(base,min,max)。 - 行为:
ColumnBox/RowBox/GridLayout不再缩小内容,空间不足即溢出、交给外层ScrollViewer。 - 修复(对齐):
GridLayout的SetHorizontalAlignment/SetVerticalAlignment判据写错(.empty()恒假)→ 永不生效;改为“全为 0”判断,Center/End生效。 - 修复(文本/IME):
TextBox/TextEdit合并 UTF-16 代理对(emoji/超 BMP)整段插入,光标/退格/删除跨整对;失焦时控件清自身组合态 +Window::ResetImeState()取消程序侧 IME 组合。SetImeEnabled(false)也清组合态。 - 修复(无障碍):
GetAutomationIdOrAuto()改每窗口计数(不再跨窗口撞号);ElementProviderFromPoint先子后父下潜到最深命中。 - 修复:数据视图项/单元格
bleedY读元素自身GetBleed();indicatorY_初始化-1(首帧指示条就位);焦点框用ThemeRole::FocusRing+Theme::cornerRadius;WM_NCHITTEST里标题栏按钮优先于缩放边框(Snap Layouts 可弹)。 - 工程:
pch.h不再含库头;新增UIElement::MarkUserColor();删死代码ListView::FindEnabledFrom。 - 文档:
docs/API.md/API.en.md版本摘录、docs/pitfalls.md、AGENTS.md同步。
2026-10-12 — API 债整理(P0~P3):.with 可用性、无歧义工厂、RAII 主题钩子、整页滚动(v1.22.0)
- 破坏性 · 带默认参数的成员函数拆成无默认参数重载(让
.with()真正可用):TreeView::SetCheckable(bool)+SetCheckableShallow(bool);SetNodeCheckable+SetNodeCheckableRecursive;SetNodeEnabled+SetNodeEnabledRecursive;SetNodeCheckState+SetNodeCheckStateFull;ListView::AddItem(text)与富项AddItemWidget(shared_ptr<Label>);RadioGroup::AddItem/AddItemSelected/AddButton/AddButtonSelected;Menu::AddCheckItem/AddCheckItemCb/AddCheckItemRadio。 - 新增 · 同名 dsl 工厂无歧义别名:
make_slider/make_card/make_page/make_menu/make_menu_bar/make_status_bar/make_radio_group/make_scroll_bar/make_expander(避开using namespace同时命中两类时的 C2872)。 - 新增 ·
Page::SetScrollableContent(content):一行把整页内容套进ScrollViewer+ 边距。 - 新增 ·
ThemeManager::RegisterHook/RegisterSubtreeApplier返回 RAIIHookHandle(析构自动断开);库内部固定钩子改用RegisterHookPermanent。 - 新增 ·
docs/pitfalls.md(易错点总表);AGENTS.md增补「链式构造 / API 约定」。 - 修复:
MessageBox(及模态框)首次点击穿透(RunModal进入前ReleaseCapture);ScrollViewer滚动链(到边界不再吞滚轮);SplitView展开无缓动 + 小按钮跳侧。 - 文档:
docs/API.md/API.en.md同步(版本摘录、make_*、SetScrollableContent、HookHandle、AddItemWidget等)。
2026-10-12 — 反馈批次:SplitView 折叠、一批渲染/布局修复、demo 首页与菜单状态栏(v1.21.0)
- 新增 · SplitView 折叠:把分隔条拖到距某侧边缘阈值内,该侧内容上方先浮出半透明强调色覆盖层 + 指向折叠方向的箭头(alpha 渐入渐出,此时不改内容);松手才真正折叠(该侧尺寸带缓动变为 0)。折叠后该侧边缘出现小按钮(圆角浅灰 + 指向展开方向的箭头 + 悬停缓动),点击后带缓动展开到最小极限值。
SetCollapseEnabled(false)可整体关闭;新增CollapsedChanged(int)信号与CollapseFirst/CollapseSecond/Expand/IsFirstCollapsed/IsSecondCollapsed等。 - 新增 · 动画口径统一:
detail::EaseOutCubic/EaseInOutCubic(时长驱动,到点精确结束)。ToggleSwitch改为 ease-in-out(DefaultAnimationDuration=0.25s,并修"点击/键盘绕过SetOn导致动画不启动 = 瞬间开关");ProgressBar数值加缓动(DefaultValueAnimDuration=0.22s)。 - 修复 · 渲染:
Card悬停闪出蓝色边框(主题给卡片设了 hover 边框色,卡片本无此行为);ProgressBar拉伸后内填充圆角与外框对不上(轨道/裁剪/边框仍在用构造时的高度)。 - 修复 · 布局:
Button文案有空间却被省略号裁掉(宽度恒为DefaultWidth,现按文案撑开,可用AutoSizeToText(false)关闭)。 - 修复 · 图表:
PieChart的zoom_遮蔽了ChartBase::zoom_导致 Ctrl+滚轮缩放无效(现由饼图自己处理);滚轮平移"画面不动"(平移路径缺SyncScrollPositions())。语义明确为 Ctrl+滚轮 = 缩放 / 普通滚轮 = 只平移。 - 文档:补充"
ColumnBox会把无显式宽度的子元素按可用宽摆(横向不吃拉伸权值)→ 卡片想按内容收窄要放进Row"、"SettingsList放进Card自带GridLayout会退化成 0 宽"两条易错点;ThemeRole::Shadow(枚举末尾追加)+Window::SetBackdrop(Backdrop)跟随主题。 - demo:新增首页(设置卡片式导航,点击跳转对应页);多窗口页改为 7 张可折叠卡片;菜单栏扩到 6 个菜单(含跳转页面/背景层/窗口尺寸/帧率上限等真改状态的子菜单);状态栏改为 5 个实时面板(页面/主题/背景/DPI·客户区/窗口状态,随主题切换与窗口信号刷新);全部
MessageBoxW换成库自带MessageBox并补齐按钮点击反馈;抽掉重复样板(section14 份、accent7 份、Scroll 包装 14 处 → 3 个共用助手)。 - 自检:
tests/zufyui_tests.cpp62 → 85 项断言(含本批修复的回归断言)。
2026-10-11 — DSL 完善 + 一键构建脚本 + 空值/自洽修复(v1.20.0)
- DSL:
root()改为接受任意Layout子类(Row/Grid原先因Ref→shared_ptr<Layout>需要两次用户定义转换而编译不过);add()按容器真实接口分派;GridLayout新增Cell(row,col,child[,rowSpan,colSpan])坐标;新增apply()/Wrap()、一批布局/尺寸/权重/配色/间距/对齐快捷,以及RadioGroup()/ScrollBar()/Glyph()工厂与数据视图、菜单构建糖。 - DSL:
WindowApp::run()补上Show()(Window::Create本身不显示窗口,原实现会跑一个没有窗口的消息循环);新增hidden/minSize/position/frameRateLimit/theme/useAppTheme/dropTarget/icon/titleBarVisible/showTitleText/menuBarInTitleBar与窗口信号on<&Window::Closed>;WindowApp改为可移动。 - 修复:
ColumnBox/RowBox/GridLayout::AddChild补空值守卫(DSL 的 variadic 转发可能送来nullptr)。 - 修复:
ZufyUIWindowTool.h补#include "ZufyUIWidgets.h"—— 它用到Label/Button却一直依赖调用方先包含。 - 工程:新增
tools/build.ps1(一键:构建前自动补 BOM → 杀占用进程 → 构建 demo +ZufyUIDebugger→ 跑自检)、tools/ensure_bom.ps1(BOM 守卫)、tests/zufyui_tests.cpp+tools/run_tests.ps1(47 项断言,不建窗口,可命令行 / CI 直接跑)。
2026-10-11 — 主题系统 + 链式构造 DSL + 卡片/拖放控件 + 一批修复(v1.18.1 → v1.19.7)
- v1.19.0:图表
ZufyUICharts.h(BarChart/LineChart/PieChart);TextEdit多行编辑器;拖放ZufyUIDragDrop.h+ 卡片控件Expander/SettingsList;ComboBox旋转箭头。 - v1.19.1:
TextEdit撤销/重做标准方案(还原选区/光标);拖放修复(落点光标、保留源选区);ScrollViewer按视口宽度测量 + 1px 出血;Label::SetImageFit(移除独立ImageView)。 - v1.19.2:
MenuBar顶部菜单栏 +StatusBar底部状态栏(默认叠在自定义标题栏上)。 - v1.19.3:主题系统(
Theme/ThemeRole/ThemeManager;浅/深/高对比度;跟随系统深浅色与强调色;实例显式设色优先);UIZSignals::ThemeChanged/ThemeReapply。 - v1.19.4:链式构造 DSL(
ZufyUIDsl.h);修复CheckBox带标签被裁;ListView/TableView缓存判据收敛为单一签名ChildrenSig();ChartBasefill 回退。 - v1.19.5:DSL 增强——
dsl::App()窗口构建器 + SFINAE 控件糖 + 图表组合。 - v1.19.6:修复
ListView按钮模式勾选框命中偏 4px、Label换行漏算子控件宽度;版本号单一来源(生成器注入1.29.1)+ 文档清理。 - v1.19.7:审计修复一批(图表滚动条占位、NumberBox 滚轮、动画集合悬垂、
Menu::ShowAt异常、布局 spacing、数据视图释放子 Label、IME 关联等);新增TODO.md合并原计划文件。
2026-10-06 — 文档与配图更新(v1.18.1)
-
重截并更新 README「快速开始」配图(
quickstart/ 背景 / 自定义标题栏 / 总览)。 -
README 第 3 步示例补上云母背景(
SetBackdrop(Backdrop::Mica, ...)),让自定义标题栏更明显。 -
新增
docs/diagrams/:截图程序screenshots.cpp+ 配图清单(含文字版“示意图”,尽量不画图)。 -
库版本宏更新为
1.18.1。 -
版本 1.18.0 → 1.18.1。
2026-10-05 — 图表控件(BarChart/LineChart/PieChart)+ 多行编辑器 TextEdit + 修复与文档重整(v1.18.0)
新增:图表(新头文件 ZufyUICharts.h)
ChartBase:数据/多系列、Nice 刻度、类别轴、网格、图例、调色板、内部滚动条、吸附轴、Ctrl 缩放、拖动平移、进场动画、水平/竖直参考线;UpdateSeriesValues实时更新不重播进场动画。BarChart:分组 / 堆叠 / 百分比堆叠 / 重叠、横向方向、每柱配色、选中高亮、描边、圆角;SetFitPlotSize让值轴铺满控件。LineChart:直线 / 平滑 / 虚线、标记点、面积填充(基线夹在可见范围内)、悬停/点击。PieChart:饼图/环形、标签+引导线、图例、悬停弹出、整圆扫入动画、滚轮缩放(SetZoom)。- 详见 API「图表」章。
新增:多行编辑器 TextEdit(ZufyUIWidgets.h)
QPlainTextEdit风格:行号、换行(WrapMode)、Tab 缩进、跨行选择、剪贴板、撤销/重做、查找、只读富文本(TextRun);自动伸缩内部滚动条;IME 候选框定位;UseCache()=false。- 基类新增
UIElement::AcceptsTab()(多行编辑器吞 Tab 做缩进,而非切换焦点)。
修复
- 高频切页内存抖动增长:
PageHost隐藏页缓存改延迟释放(隐藏约 1.2s 后才释放、整棵子树递归;期间切回复用),不再“建位图→删位图”抖动式增长。新增UIElement::ReleaseDeviceResourcesRecursive()。 - 滚动条扩张/收缩时视图不刷新:
ScrollBar动画进度变化时同时重画宿主。 - 空闲 2 秒等待缩小期间折线图不刷新:不再把“空闲缩小倒计时”当作活跃动画(否则整窗被顶进动画模式、数据重绘不落屏);空闲缩小改为惰性(到点后由下一帧触发)。
ScrollViewer离屏缓存:改为UseCache()=false(内容常变/可滚动,缓存无益且占大位图);SetUseCache(false)现在会立即释放已有位图。Snap的 DPI 上下文在 UI 线程也设置(Window::Create/WM_DPICHANGED),修非 100% DPI 下命中测试与渲染吸附不一致。ZSignal::Fire异常安全(RAII 守卫);TextBoxshift+点击自锚点扩展;TextEdit::SetCursorImpl去重复语句;Slider0 宽 NaN 守卫;ListView池标签宽度变化重测(修省略号错位)。
文档
-
API 文档按“使用分类”重整(中英):新增「图表」「无障碍与调试通道」「版本变化摘录」「易错点总表」「附录」等;全文加入
易错与版本标注。 -
版本 1.17.0 → 1.18.0。
2026-10-04 — UIA 无障碍 + 外部调试通道 + 布局拉伸权值 + 若干修复(v1.17.0)
无障碍(UI Automation,ZufyUIWindowTool.h,默认开启)
Window::SetAccessibilityEnabled(默认 true):窗口经WM_GETOBJECT暴露 UIA provider(IRawElementProviderSimple/Fragment/FragmentRoot)。UIElement无障碍 API:SetAccessibleName/Description/AutomationId/Role、GetAccessibleName/Role、GetAccessibleChildren、IsAccessibilityIgnored、GetAutomationIdOrAuto()(未设时自动e{n})。- 控件按角色暴露 Pattern(Invoke / Toggle / Value / RangeValue / ExpandCollapse);
AccessibilityNotify*主动上报;SetText/SetChecked/SetOn已自动上报属性变化。AccessibleRole枚举。 Window::GetFocusedElement/GetHoveredElement/GetPressedElement/FocusElement/HitTestElementDIP/ForgetAccessibleElement。
外部调试 / 自动化通道(ZufyUIWindowTool.h,默认关闭)
ZufyUI::SetDebugEnabled(bool)/IsDebugEnabled():开启后目标窗口响应WM_COPYDATA(dwData = 0x5A554631),回包发回wParam。库不做文件读写,只返回当前帧信息。- 命令:
1 Ping / 2 ListWindows / 3 GetFrameStats / 4 GetElementTree / 5 ForceRepaint / 6 SetElementText / 7 InvokeElement / 8 FocusElement / 9 GetElementInfo / 10 GetElementAt / 11 Highlight / 12 ClearHighlight / 13 GetErrors / 14 ClearErrors / 15~18 Top-N(重绘/布局/缓存/绘制)/ 19 ResetCounters / 20 SetVisible / 21 SetMargin / 22 SetHighlightColor;高亮框颜色可配(默认绿)。
布局拉伸权值
ColumnBox/RowBox按子元素拉伸权值分配剩余空间(SetVerticalStretchWeight/SetHorizontalStretchWeight,或SetFillHeight/SetFillWidth参与);不再用类型默认权值判定。
其它
-
省略文本自动 ToolTip:
Label(Ellipsis 截断时)悬停显示完整文本,Button委托内部 Label。 -
自定义标题栏:
CaptionButton::Kind::Pin(客户端可切换按钮,置顶)+TitleBar::AddCustomButton。 -
TreeView:TreeNode::bgColor行背景色 +GetScrollOffsetY/SetScrollOffsetY。 -
Window::DefaultBackdropColor默认纯白(0xFFFFFFFF)。 -
版本 1.16.0 → 1.17.0。
2026-10-03 — 渲染线程默认关闭 + 系统对话框(文件/文件夹/颜色)+ 稳定性修复(v1.16.0)
独立渲染线程改为默认关闭
ZUFYUI_RENDER_THREAD默认0(单线程WM_PAINT,稳定);该机制目前不稳定、bug 较多(弹窗空白、悬停/hover 与嵌套页面切换延迟、大数据量偶发崩溃等),不建议开启;仅在确需 vblank 级顺滑且能承担调试成本时置1试用。README / API 文档已注明。
新增系统对话框(ZufyUIWindowTool.h)
- 文件/文件夹:
FileDialog(新版IFileOpenDialog/IFileSaveDialog)——支持类型过滤(FileFilter多组)、多选、选文件夹、另存为、初始目录 / 默认名 / 默认扩展名;Open/OpenFiles/PickFolders/Save+*One便捷版 +FilterLabels。 - 颜色:
ColorDialog::Pick(owner, initial, opts)(ChooseColor),支持预置自定义色。 - 可选宏
ZUFYUI_ENABLE_COMCTL_V6:定义后本库注入 Common Controls v6 的 manifest 依赖(ChooseColor/MessageBox等主题化);因 manifest 是应用级的,默认不开,由应用自行决定。
稳定性 / 正确性修复
-
渲染线程结构修复:
Present1移出renderLock_(gpuLock_护交换链/设备资源);PageHost过渡态 /pages_变更统一加锁;弹窗首次显示RenderNowSync同步出帧;新增库内错误信号UIZSignals::Error(菜单/窗口/合成后端创建失败会上报,不再静默)。 -
光标:新增"期望光标"跟踪,
WM_SETCURSOR按悬停元素回设,修控件自设光标被反复重置导致的闪烁。 -
悬停穿透:有菜单打开或模态屏蔽时,主窗口元素不再悬停。
-
TreeView 首列:空间不足时依次隐藏 图标 / 勾选 / 三角,并把文字起点压回列内、文本以省略号显示(不再整条消失)。
-
TrayIcon:回调消息号不再与
WM_RENDER_TICK撞号;MenuWindow创建失败不再静默。 -
版本 1.15.0 → 1.16.0。
2026-10-03 — 数据视图虚拟化 + 跨线程并发收口(v1.15.0)
数据视图(ListView / TableView / TreeView)虚拟化
- 改为按视口虚拟化:只对可见行创建 / 布局 / 绘制单元格(池化复用 Label),百万级数据不再因行数爆炸。
ListView/TableView新增:- 隐藏:
SetItemHidden/IsItemHidden/ClearHidden; - 筛选:
SetFilter(pred)(谓词按源行号)/ClearFilter; - 可见序排序:
SetViewComparator+SortView/ClearViewSort; - 两套坐标:
VisibleCount/SourceOfVisible/VisibleOfSource/TextAtVisible/SetSelectedVisible/GetSelectedVisible(可见序),其余既有 API 一律源行号。
- 隐藏:
ListView数据 API 统一为*Item*(SetItemCount/SetItem/AddItem/SetItemHidden/SetItemToolTip/GetItemText等),移除重复的*Row*。TreeView:新增BeginUpdate/EndUpdate(批量重建可见列表,消除逐个AddRoot/AddChild的 O(N²))、SetNodeText/GetNodeText(按列写文本,空列自动补 Label)、SetNodeTooltip/GetNodeTooltip。GetChildren纯读化:所有容器的子元素列表统一在「更新阶段」由RefreshChildren()重建,GetChildren()只读——render 线程不再于渲染期改元素树。
跨线程并发收口(独立渲染线程 架构 B)
- 窗口析构 UAF 根治:引入脱离
this内存的生存令牌(alive+inFlight);render 线程批处理前先 pin,析构置alive=false并等inFlight归零(condition_variable,不烧 CPU)后才拆卸。 ComboBox/TabView/TreeView等输入与数据变更统一持renderLock_;补Window::OnMouseUp锁(修UpdateHover → OnMouseEnter/Leave的 hover 动画字段竞态)。g_imageDeviceEpoch/frameRateLimit_/windowId_改原子;AppCore窗口注册表加shared_mutex;WM_SIZEresize 请求打包成 64 位原子;~UIElement从待重绘集合反注册;字体缓存改事件驱动(GetFontFormat快路径无锁,不再每帧拷贝wstring);ComboBox::overlayConn_断连改由 UI 线程执行。- 丢帧修复:
renderRequested_在帧处理完后清除,并补偿一次唤醒,消除「去抖窗口丢唤醒 → 多等一帧到 WM_TIMER」。
ComboBox 修复
- 下拉几何统一(
UpdateListGeometry,UI 与 render 共用):命中区 / 箭头方向不再用「上一帧」的值。 - 禁用状态跨过滤持久(内部按源索引存储);新增源索引选中 API
SetSelectedSourceIndex/GetSelectedSourceIndex/SourceIndexOf。
其它修复
-
TreeView:Clear()清可见索引映射;GetNodeAtY表头不再误判;VK_UP/DOWN首末回绕;列布局改用版本号判断(不再每帧算列签名);rootDecorated_=false时根节点箭头与命中区保持一致。 -
TabView:AddTab/InsertTab/RemoveTab/ClearTabs在选中变化时补发SelectionChanged。 -
TextBox::Copy/Paste用所属窗口HWND打开剪贴板。 -
版本 1.14.2 → 1.15.0。
2026-10-02 — 修复 A1「双驱动」占用翻倍 + A3 帧率上限(v1.14.2)
- 修复(关键):A1 的 vblank tick 与旧的
WM_TIMER → HasRenderWork → InvalidateRect → WM_PAINT在动画期间同时驱动,各触发一次AdvanceFrame + RequestRender→ 每 vblank 可能出两帧 → GPU/CPU 翻倍(这就是"稳了但更耗"的根因)。现动画期间WM_TIMER让位给 tick,不再插InvalidateRect;非动画期(tooltip / 标题轮询 / 一次性重绘)仍走WM_PAINT。 - A3 帧率上限:
Window::SetFrameRateLimit(fps)/GetFrameRateLimit(),静态Window::SetDefaultFrameRateLimit(fps)/GetDefaultFrameRateLimit()。0或未设 = 跟随显示器刷新(默认,不改变现状);>0限制动画平均出帧率。实现用detail::NowMs()(QPC 单调毫秒)+detail::PreciseSleepMs()(高精度 waitable timer,不可用退化Sleep),在合成前补齐间隔。demo 加了win.SetFrameRateLimit(0);(改成60即可测降占用)。 - 版本 1.14.1 → 1.14.2。
2026-10-02 — A1 帧节拍:动画续帧去 WM_PAINT 往返(消 120/60 抖动)+ 恢复不定态 ProgressRing 演示(v1.14.1)
- A1 帧节拍(
ZUFYUI_VBLANK_CLOCK,默认 1):动画续帧不再走ContinueFrame → InvalidateRect → WM_PAINT——WM_PAINT 只在队列无更高优先级消息时才合成,会被输入消息推迟,帧开始时刻方差大 →120↔60抖动;改为渲染线程直接PostMessage(WM_RENDER_TICK)让 UI 线程跑AdvanceFrame()(从OnPaint抽出的「布局 + 动画 + 收集活跃动画」),并用frameTickPending_去抖防积压。置 0 回退 v1.14.0 行为。 - 抽出
Window::AdvanceFrame(),WM_PAINT与新的 tick 共用;DwmFlush节拍不变(present 仍对齐 vblank)。 - 恢复 demo「新控件B」页的不定态
ProgressRing(持续旋转)——v1.14.0 阶段 0 误删(那是功能演示,不是临时诊断件)。 - 版本 1.14.0 → 1.14.1。
2026-10-02 — 独立渲染线程(架构 B)+ 悬停重绘优化(v1.14.0)
独立渲染线程(架构 B)
- 渲染从 UI 线程剥离:新增进程级 render 线程负责合成 /
Present1/DwmFlush(vblank) 节拍;UI 线程只做消息、输入、布局、动画,并用去抖的RequestRender()标脏唤醒 render。 - 共享设备、各用各的上下文:
ID2D1Device与 DComp / 交换链在 UI 线程建;render 线程自建自己的ID2D1DeviceContext;元素缓存从ID2D1BitmapRenderTarget改为 device 作用域的ID2D1Bitmap1(两遍式:先在独立 DC 把脏缓存画好,主帧只 blit),跨 DC 共享成立。 - 跨线程正确性:DC 操作段用
renderLock_串行(节拍在锁外,UI 不被卡帧);WM_SIZE只置 pending、由 render 线程锁内ResizeBuffers;WM_DPICHANGED持锁串行重建;device lost 走「render 检测 → 暂停 render → 回 UI 线程重建 → 恢复」;最小化不出帧。 - 编译期开关
ZUFYUI_RENDER_THREAD(默认1);设为0退回原单线程WM_PAINT路径。
悬停重绘优化(降 CPU)
- 修「在按钮列表(
ListView)空白处移动鼠标也持续占 CPU」:根因是ListView::OnMouseMove每次移动都无条件RequestRepaint()(不管悬停项是否变化、是不是空白)→pendingRepaint_恒非空 → 每帧整窗重合成。 - 同类修复
ComboBox下拉、DataViewer网格、TreeView:只在悬停状态真的变化时才重绘(悬停高亮行为不变)。
健壮性
TabView/ProgressRing/SplitView的Draw增加arrangedRect_非有限值守卫,避免布局未就绪 / 退化尺寸触发 Direct2D 几何断言。- 版本 1.13.0 → 1.14.0。
2026-10-01 — 菜单重构:弹出层继承 Window(根治每次 +90MB)+ 窗口底层开放
菜单(重要架构重构)
- 右键 / 独立 / 子菜单的弹出层改为继承
Window(MenuWindowBase : Window+MenuWindow : MenuWindowBase),走 DComp + 进程级共享 D3D/D2D 设备 —— 根治「每弹一次菜单约 +90MB」(旧实现是WS_EX_LAYERED + UpdateLayeredWindow + DIB + 自建 D2D 工厂/DC 渲染目标,每个菜单一套软件渲染设备)。 - 柔阴影、圆角、渐显、屏幕边缘避让、点外/Esc 关闭、子菜单延时开/收,全部保留。
- 弹出层
WM_MOUSEACTIVATE → MA_NOACTIVATE、WM_NCACTIVATE → FALSE(拒绝激活),点击它们不再让主窗口收到伪WM_KILLFOCUS(这是「点菜单项不触发、直接关闭」的根因)。 MenuWindowBase可继承 → 用户可用它做自定义浮层(flyout / 面板)。
窗口底层开放(新)
- 创建参数可重写:
GetCreateStyle/GetCreateExStyle/GetCreatePos/WantDwmChrome/WantBackdrop。 - 消息拦截:
OnWindowMessage(万能入口,返回 true 拦截)+OnWindowMessageHandled(旁路观察)+OnWindowClosing。 - 自绘:
RenderContent(ID2D1DeviceContext*);SetContentOpacity(整窗不透明度,弹窗渐显)。 Window现为可继承(虚析构 + 上述虚函数)。
其它
- 菜单键盘:
↑/↓/Home/End、Enter、Esc、←/→子菜单、菜单项快捷键(Ctrl+C等);Tab关菜单。 - ToolTip:修「文字画到框外」(布局宽/高夹到渲染目标范围 + 省略号 + 截断裁剪)。
- 修复崩溃:菜单项回调里弹模态框(
MessageBox等)导致的 use-after-free ——Window::WndProc加自毁保护(HandleMessage期间窗口对象可能被析构,之后只按 HWND 判断、不再碰self);菜单项回调延迟到本帧消息处理之后再触发(detail::PostToUIThread,shared_ptr保活),彻底避开"在消息栈内被析构"。
数据视图 / 文档(v1.10.0)
- 数据视图新增坐标换算辅助
ContentToLocalX/Y+LocalToContentX/Y(把散落的arrangedRect_.x - Snap(scrollOffsetX_)收敛到一处)。 - 核对确认:数据变更方法(
SetRowCount/SetColumnCount/ 增删行列 /SetItem/AddItem…)内部均已自动InvalidateLayout+RequestRepaint;容器AddChild/SetParent自动标脏——无需手动MarkChildrenDirty。 - 文档补充「窗口生命周期与语义」(
Show/RunModal/ owned /shared_ptr)。 - 版本 1.9.6 → 1.10.0。
内部健壮性 / 性能(v1.10.1)
- 进程级 DPI 感知改到静态初始化阶段(早于
main、早于任何窗口)——原先放在Window::Create里、且忽略返回值,若进程先建过别的窗口就会静默失败、全进程坐标皆错。 Window::Create增加x/y位置参数(默认CW_USEDEFAULT;未传时仍可由GetCreatePos覆盖)。ListView子元素缓存改用逐字段比较——原来的浮点 key(项数×1e6 + 行高×1e5 + …)字段区间本身就会重叠,上万项时丢精度必撞。TreeView::TreeNode::parent改std::weak_ptr(弱引用断环),勾选沿父链直接lock(),去掉每层一次FindNode的全树搜索(原 O(n·d))。- 系统噪点贴图缓存 module 句柄 + 解码后的 WIC 位图:DPI 变化不再重复
LoadLibrary+ WIC 解码。 ImageDeviceCache::Get把 GPU 上传(CreateBitmapFromWicBitmap)移出锁(双检)。ComboBox展开列表改按需连接全局DrawOverlay:未展开的 ComboBox 不再每帧空跑。Label::Draw/Label::MeasureOverride走FontManager布局缓存(缓存 key 增加对齐 / 行距 / 多行;Ellipsis 的截断结果按原文本缓存,命中即跳过整段截断计算)。最高频控件路径,表格里放大收益。
稳定性修复(v1.10.2)
- 文本布局缓存返回值从裸指针改为强引用
ComPtr。GetRawLayout/GetDisplayLayout/GetStyledLayout/GetStyledDisplayLayout之前返回缓存内部的裸借用指针,而有界 FIFO(上限 400、一次淘汰 1/4)可能在"取到指针"与"使用"之间把条目释放 → 悬垂(大规模表格 + 高频刷新时表现为Label::MeasureOverride→GetMetrics的访问冲突)。现在调用方持有强引用,条目即使被淘汰、对象也不会失效。 FontManager的工厂初始化、formatCache_、layoutCache_/layoutFifo_统一加std::mutex保护(防御未来可能的跨线程调用)。
稳定性 / 健壮性修复(v1.10.3)
MenuWindow资源泄漏:其画笔 / 文本格式 / 描边样式是裸指针成员(不走rootElement_链),每次打开菜单都会漏一套 D2D/DWrite 资源;新增~MenuWindow()显式Release()全部。UIElement::SetParent:解绑到nullptr时旧父的childrenDirty_不置脏 → 旧父子元素列表缓存不失效;现在旧父、新父都置脏。UIElement::AttachWindowRecursive(基类):默认递归GetChildren(),修复普通控件被移动后子树windowId_不更新的问题(此前只有容器 override 才递归)。WndProc自毁保护:判据补充GWLP_USERDATA == self,并在WM_NCDESTROY清空GWLP_USERDATA,覆盖 HWND 号被复用的情形。TableView/TreeView子元素缓存:列宽校验从"列宽总和"改为顺序敏感哈希,修复交换两列宽度后缓存不失效(单元格文字停在旧位置)。
新增控件 / 滚动条抽离(v1.11.0)
- 图标系统
FontIcon+Icon(新头ZufyUIIcons.h):枚举值即字体码点;Win11Segoe Fluent Icons/ Win10Segoe MDL2 Assets运行期自动回退;字形 layout 走FontManager全局缓存。 TabView页签:顶部横向紧凑页签(文字居中 + 选中浅蓝底#D6E8FB+ 下划线指示器 + 悬停 + 圆角边框);可选关闭 ×(悬停变深色);内容用内建PageHost托管 → 切换复用过渡动画;溢出时出现 ◀/▶ 按钮(按能否再滚显隐)+ 底部横向滚动条;滚轮只在页签条上滚动页签;关闭页签时后续页签平滑移动。RadioButton+RadioGroup:圆形单选;组内互斥(显式成组,不靠父容器推断)、横/纵两种方向、组整体键盘导航(自动跳过禁用项)、选中整行浅蓝底 + 左侧竖条;SelectionChanging可否决、SelectionChanged信号 → 支持自定义互斥/联动。ScrollBar抽成独立可复用控件(从ScrollViewer提炼):自带悬停扩张 + 空闲缩小(默认 2 秒缩成细线)、回调式数值(拖动跟手 / 点轨道平滑);ScrollViewer与TabView共用同一个类。
新增控件 / 体验(v1.12.0)
ProgressRing环形进度:确定值(弧 + 值变化缓动)/ 不确定值(头部每周期整整 2 圈 + 弧长呼吸,不跳变、尾端不倒走)。NumberBox数字输入 / Spinner:内部TextBox+ 字符过滤 + 关闭 IME;右侧(框内)叠上/下步进与清除 ×(值 ≠ 默认值时出现,点击恢复默认值);空文本 → 错误(控件自身行为);ValueChanged(提交)/TextChanged(实时校验);超范围提交时夹到[min,max]。SplitView两栏分栏:可拖动分隔条(圆角 + 悬停高亮);拖动只重新标记两栏(不是重排整个控件);两栏各自按出血裁剪(SetClipRect(栏矩形 ± bleed));多栏用嵌套实现。TextBox:新增底部蓝色指示器(替换下边框、与圆角融合)、错误态(SetError,整体变红、边框粗细不变)、IME 开关(SetImeEnabled);只读不显示光标(仍可选中)。ScrollBar:抽成独立可复用控件;空闲 2 秒缩小、悬停恢复 + 悬停动画。- 修复:容器(
LayoutHost/SplitView/NumberBox)此前没有把动画 tick 递归下发给子控件 → 子控件的悬停/翻页等动画不跑;现已补齐。
帧节奏修复 · 动画丝滑(v1.12.1)
- 现象:帧率测着是 60,肉眼却像 30–40("卡卡的")。
- 根因:帧间隔不均匀(不是帧率低)。
WM_TIMER里排队InvalidateRect→WM_PAINT会被鼠标/键盘消息插队,帧开始时刻漂移,再被Present1(1)量化成整 vblank 的错位;叠加定时器(~15.6ms)与 vblank(16.67ms)天生错位 → 周期性微顿。 - 修法(两处,都很小):
WM_TIMER里改用RedrawWindow(…, RDW_INVALIDATE | RDW_UPDATENOW)—— 同步触发 WM_PAINT,绕过消息队列被插队;OnPaint在Present1(1)返回后立刻排下一帧(InvalidateRect)—— 让节拍由 vblank 决定,而不是定时器。
- 效果:主观帧率显著变顺,动画接近原生 WinUI。
右键菜单 / CPU 修复(v1.12.2)
- 修「主窗口有持续动画时右键菜单完全不出现」:根因是
WM_PAINT的检索优先级高于WM_TIMER—— 主窗口 present 循环每帧发一个WM_PAINT,把菜单窗口的淡入定时器和它自己的WM_PAINT一起饿死 → 菜单永远停在透明度 0(看起来"没弹出来")。改为显示时立即置为不透明 +RedrawWindow(RDW_UPDATENOW)同步画一帧,不再依赖被饿死的定时器。(副作用:菜单不再淡入,改为即时出现 —— 为了在持续动画下可靠显示。) - 降 CPU:
HasRenderWork()去掉「鼠标停在任何带 tooltip 的元素上就恒为 true」的判据 —— 它会让定时器每 16ms 全窗重绘一次。tooltip 的 500ms 延迟与渐显本来就由定时器里的UpdateTooltip()推进,不需要靠"重绘"驱动。 - 降 GPU:不再把整棵「活跃动画集合」(一个转圈圈会带出十几个祖先容器)每帧塞进
pendingRepaint_—— 实测那会导致整窗每帧重新合成(约 10% GPU)。 - 帧节奏:
WM_TIMER回到InvalidateRect(去掉上一版的RDW_UPDATENOW同步画),避免与 present 驱动叠成"每帧画两遍"、还堵消息泵;present 驱动下一帧的门控从HasRenderWork()改为「确有动画在跑」,避免自持死循环饿死WM_TIMER(否则 tooltip 不弹)。 - 菜单:
MenuWindow里GetFactory的AddRef未配对Release(每次菜单漏一个 factory 引用);同一子菜单已展开时不再重复展开。 - 控件:
TabView::LayoutStrip加零尺寸守卫(避免零宽高下的异常排列);ProgressRing改UseCache()=false(每帧都变,缓存只会白重建一遍);NumberBox::ResetToDefault()恢复默认后清除错误态并触发TextChanged。 - 版本 1.12.1 → 1.12.2。
框架 Timer / Label 图标 / 页签用 Label(v1.13.0)
- 框架
Timer(信号通知):Window::CreateTimer(ms)→std::shared_ptr<Timer>,Timer::Tick是ZSignal<>;底层仍是WM_TIMER,但 id 用框架保留段(0x7F00+),不干扰库内部定时器与应用自定义 id;窗口先析构自动解绑、Timer 先析构自动Stop+注销。 Label内置字体字形图标:SetIcon(Icon[,size])/SetIconColor/GetIcon(复用原「图片图标」槽位;size<=0跟随字号;颜色默认取文字色;只设图标无文字 = 纯图标标签);「图标 + 文本(+子控件)」作为一个整体做左右对齐(按钮里图标与居中文字贴在一起)。- 图标系统下沉到核心:
Icon/IconGlyph/IconFontFamily从ZufyUIIcons.h移到ZufyUIWidgets.h,任何控件都能直接用;FontIcon/MakeFontIcon仍在ZufyUIIcons.h。 Button转发图标:SetIcon/GetIcon/SetIconColor(转发给内部Label)。TabView页签标题改为Label:AddTab(shared_ptr<Label>, …)/SetTabLabel/GetTabLabel(wstring重载保留为便捷写法)→ 页签天然支持图标。ScrollBar::ShrunkWidthRatio(默认0.30):宿主据此留边;TabView的「标签条 ↔ 内容」间距改为「细线粗细」。- 帧循环改进(针对「动画期间定时器/弹窗被饿死」):present 自续前先派发到期的
WM_TIMER(修定时轮询不准时);并新增让位闸门HasSiblingWindowNeedingPaint()(EnumThreadWindows+GetUpdateRect精确判据)——本线程若有其它窗口正等着出画,本轮不给自己排帧,避免其重绘被无限期推迟。 - 菜单打开淡入恢复(
ShowAtPoint:先同步画一帧把内容渲染出来,再SetContentOpacity(0)+ 淡入;WM_TIMER 不再被饿死)。 - 版本 1.12.2 → 1.13.0。
2026-09-26 — 托盘 / 任务栏 / 菜单增强 + 应用身份自注册
菜单
- 重做右键菜单为分层窗口 + 自绘柔阴影 + 圆角 + 渐显;修复「第二次弹不出」(根因:勾选对勾的
ID2D1StrokeStyle静态跨工厂复用 →EndDraw报D2DERR_WRONG_FACTORY,改为随实例工厂创建/释放)。 - 菜单项增强:
id/ 勾选 / 单选 / 默认项(加粗 + 回车)/ 危险项(红字)/ 快捷键提示 / 禁用;逐项bgColor/textColor/font;Menu::font/SetDefaultFont。 - 动态菜单工厂
UIElement::SetContextMenuFactory(每次右键现搭)+SetContextMenuEnabled。 - 独立弹出
Menu::ShowAt/ShowAtCursor(不绑定窗口,托盘菜单用);开关菜单互斥。 - 悬停高亮改为半透明叠加(自定义底色上仍可见)。
托盘 / 任务栏 / 图标
TrayIcon(Shell_NotifyIconv4):悬停 / 点击 / 右键 / 双击、徽章(自绘合成)、气泡通知(ShowBalloon,BalloonIcon可选 None/Info/Warning/Error/Custom,支持实时 / 静音);explorer重启自动重加。- 任务栏:进度(
SetTaskbarProgress)、覆盖徽章(SetTaskbarOverlayIcon)、缩略图工具栏(SetThumbButtons,Image版自动建HIMAGELIST)、跳转列表(SetJumpList,Tasks + 分类 + 最近)。 Window::SetAppIcon(统一原生大/小 + 类图标 + 自定义标题栏)、ShowActivate(四模式)、Flash(FLASHW_ALL);TitleBar图标徽章 / 进度。Image::ToHICON/CopyPixelsBgra。
数据视图
ListView::ItemRightClicked(row)+GetContextRow();TableView::CellRightClicked(row,col)+GetContextRow()/GetContextColumn(),支持列表/表格右键菜单。
应用身份自注册(新)
- 声明
AppInfo{ displayName, aumid, icon }+RegisterApp(...)(自由函数 /Application::RegisterApp转发):统一进程 AUMID,让 toast / 跳转列表 / 任务栏分组归属同一身份。 - 需显式授权宏
ZUFYUI_ALLOW_APP_REGISTRATION;授权后写注册表HKCU\...\AppUserModelId\<AUMID>(DisplayName + IconUri)+ 把图标缓存到%LOCALAPPDATA%\ZufyUI\AppReg\<AUMID>\app.ico,进程退出清理缓存与注册表项;未授权则只设 AUMID、零副作用。
构建
- 引入预编译头
pch.h/pch.cpp(改 demo 的编译 ~1.1s);Release关闭调试信息;Debug补/bigobj。
说明(历史):菜单弹出层早期走「分层窗口 + 软件渲染目标」且每个菜单自建 D2D 工厂 → 每弹一次约 +90MB;自 v1.8.0 重构(
MenuWindowBase : Window+ DComp + 进程级共享设备)已根治。保留此条仅作历史记录。
2026-09-20 — 性能优化 + 背景 API 收敛(v1.9.6)
- 性能:切页内存峰值 300–400MB → ~30MB 封顶;布局机制重构(DesiredSize 缓存 + 两级脏位,去掉"布局失效即全清缓存"、切页不再全量重排);拖动/缩放期间不再每帧整树命中检测;全局文本布局缓存(跨控件共享)+
Label省略号改二分;去每元素GetDpi()。 - 背景 API 收敛为"背景层三选一 + 叠加色":
Backdrop只有None / Acrylic / Mica;删除BackdropMode;删除ReloadAcrylic/ReloadMica;新增SetBackgroundParams(层, BackgroundParams/AcrylicPreset)与AcrylicParams/MicaParams。亚克力/云母一律由 ZufyUI 自己实现,Win10 与 Win11 效果一致。 - 数据控件:
ListView新增BeginUpdate/EndUpdate批量增删。 - 一批修复:排序补发
SelectionChanged、ComboBox过滤保留选中、TextBox撤销栈、CaptionButton按下行为、滚动条除零守卫、图像缓存加设备代次等。
2026-09-19 — 1.8.0 后续修复与完善(v1.8.1)
背景
- DComp 亚克力背景层改为可运行时重建(新增
UpdateDCompBackdrop()):SetBackdrop/SetBackdropMode在窗口创建后再切换也会生效;Acrylic → Mica/其它时会正确清除旧背景层(不再露底/发黑);设备丢失重建后也会重新挂上。
窗口
- 新增
Window::SetTitle(const std::wstring&)与Window::SetIcon(HICON bigIcon, HICON smallIcon)(原生标题栏;自定义标题栏请用TitleBar::SetTitle)。 SetCustomTitleBar会套用当前SetTitleBarVisible状态,消除"先隐藏再装栏"的不一致。
信号(连接)
Connection改为 QtQMetaObject::Connection风格的被动句柄:可拷贝、析构不再自动断连;UIElement::Connect(...)现在返回Connection,忽略返回值安全,需要单独断开时auto c = elem->Connect(sig, slot); … c.disconnect();。自动断连仍由元素的ConnectionGroup负责(ImageManager的 DeviceReset 订阅同样改走 group)。移除冗余的autoConnections_。
数据视图 / 控件
TableView单元格键由(long long)row*10000+col改为(uint64)row<<32 | col,修列数 ≥ 10000 时键冲突(cellSel_/cellTextColors_/cellTips_)。ListView::MoveItem现在会触发SelectionChanged(并EnsureVisible)。ComboBox选项宽度加缓存(仅数据变化重算),SetToolTip移出Measure(去每帧测量与副作用)。ScrollViewer内容裁到视口(新增UIElement::SetClipRect),不再画到滚动条下面;滚动条本身不受影响。
其它
PageHost新增过渡缓动TransitionEasing { Linear, EaseInOut, EaseOut },默认EaseInOut(缓入缓出,平滑);SetTransitionEasing切换。- 进程 DPI 感知只设置一次;删除
D2DERR_RECREATE_TARGET死判断。 - 修复内存泄漏:
AppCore::dqController_改用ComPtr持有并释放。 - demo:移除独立的"自定义标题栏窗口"(主窗口已是自定义标题栏)。
2026-09-19 — 渲染迁移到 DirectComposition + 背景/信号 API 重整(v1.8.0)
渲染:迁移到 Direct2D 1.1 + DXGI flip SwapChain + DirectComposition
Window不再使用ID2D1HwndRenderTarget,改为ID2D1DeviceContext+IDXGISwapChain1(CreateSwapChainForComposition)+ DComp 视觉树,窗口加WS_EX_NOREDIRECTIONBITMAP,内容经 DComp 提交、支持逐像素透明。AppCore进程级共享ID3D11Device → IDXGIDevice → ID2D1Device与 WinRTICompositor,多窗口复用。- 设备丢失/DPI 变化/尺寸变化走统一的资源丢弃与重建(
DiscardDeviceResources/ResizeSwapChain),并新增DeviceLost/RenderingError信号。
亚克力:改用 DComp HostBackdropBrush + 高斯模糊
- 亚克力由 DComp 背景层(
ICompositor3::CreateHostBackdropBrush,回退ICompositor2::CreateBackdropBrush,外包高斯模糊效果)采样宿主背景绘制,配合DWMWA_USE_HOSTBACKDROPBRUSH+AccentState(HOSTBACKDROP);不再依赖会随窗口框架失效的DWMWA_SYSTEMBACKDROP_TYPE。 - 附带手写的
IGraphicsEffect/IGraphicsEffectD2D1Interop封装(无需 Win2D),依赖新增d2d1effects_2.h与dxguid.lib。
背景 API 重整(表示“要什么” vs “用什么 API”)
- 新增
Backdrop { None, Normal, Blur, Acrylic, Mica, MicaAlt }:表示要什么效果。 BackdropMode { Auto, System, Accent }:表示用什么 API 实现。SetBackdrop(Backdrop, tint = 0)/GetBackdrop()、SetBackdropMode/GetBackdropMode()。- 删除旧的
WindowBackdrop/SystemBackdropMaterial(含义与命名混淆)。
回调 → 信号(统一用信号槽)
UIElement的事件由裸std::function成员改为信号:MouseEnter / MouseLeave / MouseMove / MouseDown / MouseUp / KeyDown / KeyUp / Char / Focused / Blurred。MenuItem::Clicked、CaptionButton::Clicked(默认行为由DefaultTitleBar接线,自定义标题栏可自行连接/拦截)。- 新增
Window::Closing(ZSignal<bool*>,槽可置*cancel=true取消关闭,用于“关闭前询问保存”)、Window::BackdropUnsupported/Window::DeviceLost/Window::RenderingError。 - 全局
UIZSignals::DeviceReset:渲染设备资源被丢弃/重建时触发,供订阅者清理按设备缓存(ImageManager据此清图像位图缓存,修复旧渲染目标指针悬垂与位图泄漏)。 - 删除
SetBackdropUnsupportedHandler/SetDeviceLostHandler/SetRenderingErrorHandler。
窗口
Window::Create不再自动显示,何时显示由应用Show()决定。- 自定义标题栏新增每个按钮的启用/可见控制:
TitleBar::GetButton / SetButtonEnabled / IsButtonEnabled / SetButtonVisible / IsButtonVisible;DefaultTitleBar便捷封装SetMinimizeEnabled / SetMaximizeEnabled / SetCloseEnabled及对应...Visible。 DWMWA_BORDER_COLOR默认改为系统默认(不再硬编码灰色)。
修复与清理
- 组合框弹出列表的 hover/点击判定改用与绘制一致的宽度(
ListWidth()),修右侧超出区域点不到。 TableView::SortByColumn排序后同步重映射checkedRows_。- 双击判定改用系统
GetDoubleClickTime()(三处)。 ScrollViewer::Arrange用SetVisibleNoInvalidate()避免布局循环;DrawTextWithEllipsis截断由 O(n²) 改为二分。MenuWindow多显示器定位改用MonitorFromPoint+GetMonitorInfo。- 清理多项兜底/临时逻辑(
PageHost调试特例、无用的animationIdleFrames_等)。
测试程序(ZufyUI.cpp)
- 主窗口改为自定义标题栏。
- 移除独立的小工具窗口,多窗口 / owned / 模态演示移入主窗口的**“多窗口”页**。
- 版本号提升到 1.8.0(新增
ZufyUI_VERSION_STRING等宏,demo 标题引用)。
2026-09-16 — 自定义标题栏(ZufyUIWindowTool)与背景三模式
新增:自定义标题栏(新文件 ZufyUIWindowTool.h)
TitleBar/CaptionButton/DefaultTitleBar:窗口级控件,作为“不参与布局”的覆盖控件由Window::SetCustomTitleBar安装;传nullptr恢复原生标题栏。- 三件套用系统图标字体绘制(
Segoe Fluent Icons/Segoe MDL2 Assets,码位E921/E922/E923/E8BB),带 hover/pressed 渐变,关闭悬停红#C42B1C;按钮在WM_NCHITTEST报告为HTMINBUTTON/HTMAXBUTTON/HTCLOSE,从而启用系统 Snap Layouts;点击在WM_NCLBUTTONUP处理;标题栏区域为拖动区域(拖动 / Aero Snap / 双击最大化交给系统)。 - 标题栏与按钮不参与 Tab 焦点;默认
DrawAfterLayout、UseCache(仅状态变化重绘)。 - 便捷设置:
SetTitleBarVisible、SetButtonsEnabled、SetButtonWidth/Height、SetRightMargin、CaptionButton::SetAnimationSpeed等。
新增:布局参与 / 拖动机制(UIElement)
LayoutParticipation { Normal, DrawBeforeLayout, DrawAfterLayout }:不参与布局的元素由 Window 在正常布局树之前/之后单独绘制;布局与ComposeImpl子递归都会跳过它们。- 拖动区域:
SetDraggable / SetDragRegion / CollectDragRegions;Window 每帧收集并交WM_NCHITTEST(返回HTCAPTION)。
新增:背景三模式
BackdropMode { Auto, Acrylic, SystemBackdrop }+SystemBackdropMaterial { Auto, Mica, MicaAlt, Acrylic }+SetBackdropUnsupportedHandler(运行时不受支持的回调)。SystemBackdrop走 Win11DWMWA_SYSTEMBACKDROP_TYPE;不支持时回调并回退AccentState。
窗口 / 边框修复
- 分屏(Snap)状态保留 DWM 边框与阴影:
WM_NCCALCSIZE只内缩被吸附到工作区边缘的那几条边(内缩量取DWMWA_VISIBLE_FRAME_BORDER_THICKNESS的实际厚度),最大化不内缩;最大化/还原/分屏状态变化时发SWP_FRAMECHANGED重算框架。 - 最大化时贴顶下拖可还原窗口;关闭键位置与原生一致。
演示:ZufyUI.cpp 新增“自定义标题栏窗口”。
已知限制(重要)
- ZufyUI 当前渲染在
ID2D1HwndRenderTarget(不透明重定向表面)上,无法显示 DWM 系统材质:BackdropMode::Auto目前在 Win10/Win11 都走AccentState;SystemBackdrop模式在渲染目标迁移到 DirectComposition 之前不可见(会发灰/发黑)。 AccentState亚克力是未公开 API,会让 DWM 跳过最小化/最大化等窗口过渡动画(Win10/Win11 均如此)。要同时获得“亚克力 + 原生动画 + Mica”,需把渲染迁移到 DirectComposition(SwapChain / CompositionSurface),属后续规划。
2026-09-15 — 图像系统、窗口机制增强与多项根源修复
图像(新增 ZufyUIImages.h)
- 新增
Image:WIC 解码 + Direct2D GPU 绘制/变换。加载:FromFile / FromMemory / FromBase64 / FromResource(HMODULE,name,type) / FromResource(id,type) / FromHBITMAP / FromHICON;变换:Scaled / ScaledToWidth / ScaledToHeight / Rotated / Mirrored / Cropped(轻量描述符,绘制时 GPU 施加);绘制:Draw(opacity / 插值)、Bake;编码:Save / Encode(CreateStreamOnHGlobal内存流,无临时文件)。 ImageManager:共享IWICImagingFactory并登记设备缓存;ImageDeviceCache:每个渲染目标一张ID2D1Bitmap缓存,设备丢失统一重建。同一图像同一窗口只上传一次 GPU 位图。- 根源修复:
IWICStream::InitializeFromMemory不复制内存,而解码/转换是惰性的;改为在解码时用WICBitmapCacheOnLoad立即把像素拷进独立 WIC 位图,避免FromMemory/FromBase64/RT_BITMAP在绘制阶段读到已释放内存(此前表现为图像完全不显示)。 - 根源修复:
DrawWithTransform的变换矩阵合成顺序写反,导致旋转/镜像后的图像被推出目标矩形(表现为旋转/镜像什么都看不到);改用带center的Rotation/Scale重载。 Label支持图标与嵌套子控件:SetImage/GetImage、SetIconSize/GetIconSize、SetIconSpacing/GetIconSpacing、AddChild/ClearChildren/GetChildCount(图标 + 文本 + 子控件内联横排)。
窗口
RunModal改为官方机制:EnableWindow(owner, FALSE)+ 激活模态窗 +IsDialogMessage嵌套循环;移除了全局低级鼠标钩子(之前会吞掉其它进程的点击,模态一开整个桌面点击失灵)。- owned 子窗口:创建时即通过
CreateWindowEx的父窗口参数建立所有者关系,因此不再有独立任务栏按钮;父窗口最小化时无条件隐藏其 owned 子窗口、还原/激活时恢复(不再依赖系统“最小化分组”,避免父窗口在后台时子窗口不跟随)。 - 新增便捷 API:
Flash(times=5, captionOnly=true)/StopFlash()(FlashWindowEx)、GetOwnedWindows()、GetStyle()/GetExStyle()、SetWindowStyleFlag/SetWindowExStyleFlag(如WS_EX_TOOLWINDOW)、Show()/ShowNoActivate()/Hide()/Raise()。 - 新增
OwnedMinimizePolicy { None, Hide, DisableMinimize }+SetOwnedMinimizePolicy:处理 owned 子窗口被单独最小化的方式。 - 修复:窗口销毁时清除其它窗口对它的裸引用(
owner_/ 隐藏列表),避免地址被复用后牵连不相干的窗口。 - 修复:
SIZE_RESTORED在拖拽改变窗口大小时也会触发,之前会无条件恢复已隐藏的 owned 子窗口(拖一下大小子窗口就冒出来);改为只在“最小化 → 还原”时恢复。
控件 / 渲染
- 根源修复:元素缓存位图合成到主渲染目标时,目标像素尺寸必须与位图像素尺寸完全一致,否则任何插值都会把缓存整体重采样,导致文字发糊;改为用位图实际像素数反推目标尺寸。
ComboBox:折叠框宽度按选项文本平均宽度自适应(放不下时省略号截断 + 自动ToolTip显示完整文本);下拉列表宽度按最宽选项自适应,保证每个选项完整显示;修复“列表比框体宽时滚动条画到中间”的问题。
文档
- API 文档新增“图像”章节(中英),并补充
Window、Label、ComboBox的新 API 与要点。
2026-09-13 — 大优化:交互状态、阴影 / ToolTip、控件与数据视图增强
核心框架
UIElement新增:启用/禁用(SetEnabled/IsEnabled/IsEffectivelyEnabled,禁用状态沿父链继承、拦截鼠标键盘、控件自行置灰)、通用 ToolTip(SetToolTip/GetToolTip)、阴影(SetShadow/SetShadowColor/SetShadowBlur/SetShadowOffset/SetShadowCornerRadius/GetShadowExtent)、右键菜单钩子OnContextMenu。Window:元素阴影合成进离屏缓存;统一 ToolTip 浮层(锚定“显示时鼠标位置”上方固定偏移、悬停 0.5s 渐显、白底黑字带柔和阴影、鼠标移动即关闭);Tab 焦点遍历(焦点环仅在 Tab 导航时显示,鼠标点击不显示)。- 阴影重写为 高斯 CDF 分层(
DrawSoftShadow):按高斯分布分配每层 alpha,使叠加结果逼近targetA·(1-Φ(d/σ));SetShadowColor的 alpha 语义为“边缘可见透明度”,内部约为其 2 倍。 - 帧时间钳制:
OnPaint的deltaTime上限0.033s,修复空闲 / 最小化恢复后“动画一帧跳到终点”的问题。 PageHost修复切页动画期间同一页面每帧被UpdateAnimation两次、导致页面内嵌动画速度翻倍的问题。- 定时器精度:窗口创建
timeBeginPeriod(1)、销毁timeEndPeriod(1),降低动画抖动。 - 调试输出统一由宏
ZufyUI_DEBUG控制(默认关闭,定义后启用),Release 热路径不再有调试字符串构造。 - 性能 / 内存:
GetChildren()改为返回const&(复用缓冲,消除每帧每节点分配);ZSignal::Fire用线程本地快照;Compose增加裁剪剔除(完全在裁剪区外的子树直接跳过);活跃动画集合复用缓冲;DrawSoftShadow用定长数组避免每帧堆分配。
基础控件
Button:禁用态、Enter/Space 键盘触发、可切换(SetCheckable/SetChecked/IsChecked/Toggled)、文字对齐 / 内边距、自动重复。CheckBox:悬停光晕动画、文字标签与颜色、悬停框色、键盘、禁用。ToggleSwitch:禁用、文字标签、键盘、SetSize、不确定态、自定义颜色。Label:内边距、行距、最大行数(超出省略)、GetDesiredSize、禁用色。ProgressBar:ValueChanged、范围、显示百分比文本与文字颜色、禁用。Slider:SliderReleased、步进 / 吸附(SetStep/SetSnapToStep)、方向键 / Home / End、禁用。ScrollViewer:滚动条可见性策略(Auto/Always/Hidden)、ScrollChanged、GetScrollOffset、实例颜色、ContentMargin。TextBox:只读(SetReadOnly)、输入过滤(SetInputFilter)、ReturnPressed、公开选区 / 撤销 / 复制粘贴 / 全选、占位符颜色、密码显隐(SetRevealPassword);修复 Shift 与鼠标拖选“选区不累积”的问题(引入独立锚点)。ComboBox:数据增删查、占位符、每项禁用、最大可见项、开合信号(DropDownOpened/DropDownClosed)、可编辑 + 输入过滤(SetEditable/SetFilterEnabled/SetEditText,带闪烁光标与点击定位)。
数据视图
ListView:选择模式新增None;首字母定位(type-ahead);排序回调 + 排序指示;每项禁用 / 单独文字色 / ToolTip(按项目绑定,排序后仍然跟随原项目);键盘上下键跳过禁用项。TableView:按列排序 + 排序指示(排序 / 增删行列时行级元数据随行重映射);单元格文字色 / ToolTip;按行禁用;列隐藏;列对齐;按行高度;键盘上下键跳过禁用行。TreeView:过滤 / 搜索、GetNodePath、默认展开深度;节点tooltip接入基础类的统一 ToolTip。
文档
- 新增本更新日志;API 文档从“定义罗列”改为更详细的“实现要点 + 易混点”风格;补充信号与对象生命周期的引用环警示。
2026-09-13(续)— 多窗口支持(Application)
- 新增
ZufyUI::Application:app.CreateWindow(...)创建窗口、app.Run()运行单一共享消息循环,Qt 风格;窗口之间真正独立。 - 重绘 / 布局按所属窗口路由(
UIElement::GetWindow());DPI 缩放改为线程本地(每个窗口渲染前设置自己的缩放);Window新增实例信号Activated/Deactivated/Closed,全局UIZSignals::WindowDeactivated与GlobalMouseDown增加Window*参数。 - 关闭单个窗口不再退出应用,最后一个窗口关闭才退出;
ID2D1Factory与timeBeginPeriod由应用核心共享。 - 所有窗口相关全局信号统一带
Window*(含DrawOverlay/GlobalMouseDown/WindowDeactivated及捕获、重绘兜底),订阅者用GetWindow()过滤;修复“A 窗口的下拉弹层被画到 B 窗口 / 点击 B 导致 A 误收起”的串扰。新增Window::SetPosition/SetSize/IsValid。 - 修复“ComboBox 展开后一直持有系统鼠标捕获、导致其它窗口无法使用”:Win32 捕获只在按住鼠标期间持有,松开立即释放(元素级逻辑捕获不受影响);另处理
WM_CAPTURECHANGED。 - 新增模态与 owned 父子窗口:
Window::SetOwner/GetOwner、Window::RunModal(owner)、Application::CreateWindow(..., owner);模态期间点击被禁用的父窗口会让模态窗口闪烁提示。 - 稳健性:元素改用窗口 id 记录所属窗口(替代裸指针),窗口销毁后
GetWindow()返回 nullptr,消除“悬垂窗口指针”导致的崩溃。 - 修复
PageHost过渡结束后每帧重复对非当前页ReleaseDeviceResources()的问题(改为仅在过渡完成的那一帧释放一次);非当前页会被设为不可见,其中的展开控件(ComboBox)随之自动收起。 - 修复
UIElement::Connect返回被移动过的空Connection的隐患(改为不返回);修复TreeView::RemoveChildren未清理checkAnim_造成的悬垂节点键。 - 新增
AGENTS.md,固化“任何 bug 先定位根源、从根源修复,不用新机制掩盖”的开发原则。 - 向后兼容:单窗口
Window win; win.Create(...); win.Run();仍可用。#undef CreateWindow以避免与 Win32 宏冲突。