ZZufyUI文档首页DocumentationДокументацияDokumentationDocumentationDocumentación

正在准备文档Preparing your docsПодготовка документацииDokumentation wird geladenPréparation de la documentationPreparando la documentación

Language

Changelog / v1.29.1

Changelog

Download Markdown

Full history with per-item details. README keeps a concise version history.

Current version: 1.29.1 (source of truth is ZufyUI_VERSION_STRING in ZufyUI.h; this changelog and the API doc header both derive from that macro).

2026-11-20 — PageHost animation and pointer-cancel fixes (v1.29.1)

  • PageHost reverse transition: restored the EaseOut inverse to 1 - cbrt(EasedProgress()), removing the reverse jump.
  • PageHost hit testing: during animation, points are inverse-translated with each page's GetChildRenderTransform before hit testing; hover/click/right-click no longer hit an element at its unshifted position.
  • PageHost page removal: RemovePage adjusts or cancels fromIndex_ / toIndex_ during animation and leaves no stale indices.
  • OnPointerCancel wiring: WM_CANCELMODE / WM_CAPTURECHANGED now cancel pressedElement_ / mouseCaptureElement_ and clear capture; OLE drag-out is exempt so file drag-out keeps working.
  • Show events: Opening / Opened now fire for menus and other WantDwmChrome()==false windows, and PresentationState reaches Open.
  • Regression tests: added headless PageHost checks for reverse animation, transformed hit testing and page removal; updated the TODO.md baseline to 1.29.1.
  • Verification: x64 / x86 Release + ZufyUIDebugger builds and full self-tests pass.

2026-11-20 — Pointer/focus feedback, window transitions and docs (v1.29.0)

  • Pointer / focus / input feedback: added SetPointerCursors / GetPointerCursorAt / OnPointerCancel; TextBox gained focus background/border, caret colour/thickness, indicator and password-eye fixes; ComboBox supports keyboard expand and up/down selection; Slider commits the final release coordinate; ListView/TableView/TreeView, ScrollBar, Expander, SettingsList and NumberBox gained cursor/cancel handling.
  • Layout / font fixes: Expander, SettingsList, ChartBase/PieChart now inherit the effective font; MenuBar reserves fractional glyph width; Button FillWidth measurement is fixed; ListView defers EnsureVisible before first Arrange; title-bar active title colour is fixed.
  • Window transitions: added PresentationState, SetTransitionDurations, GetPresentationState, GetPresentationProgress, IsTransitionActive and DefaultWindowSetup; normal windows fade with DComp, default duration remains 0, and menu-owned opacity animation is unaffected.
  • Menus / PageHost: menu click callbacks use QueueToUIThread so a menu cannot be destroyed on the WndProc stack; PageHost supports reversing mid-transition and fixes the EaseOut reverse progress calculation.
  • Docs: fixed chapter 8 title mojibake, the companion README link and four API doc lines; regenerated the Chinese and English API docs.
  • Verification: x64 / x86 Release + ZufyUIDebugger builds and full self-tests pass.

2026-11-19 — Nonblocking Present, high-refresh pacing, private fonts, UIA lifetime (v1.28.0)

  • Nonblocking Present: opt-in Window::SetNonBlockingPresent. When enabled, Present1(0, DXGI_PRESENT_DO_NOT_WAIT); a busy queue is retried by the existing timer/frame clock without blocking or busy-spinning.
  • High-refresh pacing: SetDisplayFramePacing / GetDisplayRefreshHz and ZufyUIFrameClock.h. The worker only arms a timer and posts a message; layout/drawing/Present stay on the UI thread. Off by default; menus enable it by default.
  • Menu sync: MenuWindowBase uses nonblocking Present + frame pacing by default; UseNonBlockingPresent / UseFramePacing are static opt-outs. Hide, close, WM_DESTROY and destruction call Stop() on the clock.
  • Private fonts: FontManager::SetAppFontCollection; install before any format/layout, the manager holds a reference. Menu paths that call CreateTextFormat directly still use system fonts.
  • UIA lifetime: root and child providers share DetachElement + UiaDisconnectProvider; WM_DESTROY calls UiaReturnRawElementProvider(hwnd,0,0,nullptr); UiaDisconnectProvider runs outside UiaMutex; SetRootLayout / SetAccessibilityEnabled(false) release consistently.
  • Demo: window-properties page gained nonblocking Present / pacing toggles; popup page covers placement, follow, bounds, close policy and event logs.
  • Verification: x64 7408 / x86 7425 self-tests pass.

2026-11-19 — Popup window behavior (v1.27.3)

  • Window placement: Window::Placement (system default / center on owner / center on screen) plus CenterOnOwner/CenterOnScreen.
  • Owner follow and move bounds: SetFollowOwner and MoveBounds (unrestricted / owner client / monitor work area); owned child windows follow owner movement and are constrained.
  • Close policy: CloseReason, RequestClose, ForceClose, and Opening/Opened/CloseRequested/CloseAccepted/CloseCancelled; supports disabled close, Escape close, close veto, and forced close.
  • Title bar integration: the custom title bar close button uses RequestClose(Caption); BehaviorChanged keeps the maximize button disabled in owner-client mode.
  • Popup first frame: RenderNowSync advances layout and renders a frame on first Show, reducing blank first frames.
  • Attribution: the popup behavior was adapted from whrct22's ZufyUI fork (MIT, commit 33c9d7e); see THIRD_PARTY_NOTICES.md.
  • Verification: x64/x86 Release + ZufyUIDebugger builds and self-tests pass.
  • Demo release: standalone x64 demo.exe, redesigned home, component search, icon navigation and live control playground; all 26 demo pages retained. Light/dark themes, shared Acrylic backdrop through the title/status bars, and 180 ms page transitions.

  • Assets: original multi-resolution application icon; MiSans VF regular design frozen and subsetted for source text, embedded in the executable with system glyph fallback for open-ended input.

  • Interaction fixes: defer ListView scrolling until a viewport exists; measure fill-width rich Button content at its allocated width; reserve fractional-glyph rounding space in MenuBar. Added layout regression assertions.

  • Version resources: library and executable metadata share ZufyUIVersion.h; export and documentation build scripts use the same source.

  • Included work: header-only core/widget module extraction; opt-in unified styles and live style edit/undo; JSON CLI and 18 MCP debug tools with verified window identity and structured errors.

  • Runtime validation fixes: commit the slider release coordinate even when the last move message is coalesced; update active title text with the theme; refresh Gallery input/progress colors in dark mode. Packaging validates executable versions and the embedded font hash.

  • Real font weights: embed actual Regular and Semibold MiSans faces with normalized static metadata, eliminating simulated bold. Component entry titles/descriptions use Regular. Settings rows, expander headings and default chart fonts respect the application font.

  • Compound controls: draw password eyes with cached, uniformly scaled curves. GetPointerCursorAt resolves text and action regions separately. Add pointer feedback for number-field actions, sliders, standalone scrollbars and scrollbars painted inside lists/tables/trees. Disabling IME no longer changes the number field's text cursor. Capture cancellation clears drag state; regressions cover regions, disabled state, cancellation and rendering resources.

  • Readability review: settings rows and expander headers use action cursors. Advanced inputs and eight actions on the input/scroll page use two columns so labels remain readable. Constructing the environment test page no longer overrides the requested startup theme.

2026-11-14 — Stability, control interaction and full-pane transition patch (v1.27.2)

  • Window raw-pointer / UIA crashes: added Window::ForgetElement to clear focus, pressed, capture, hover, tooltip, pending-repaint and UIA provider caches in one place; UIElement::SetParent detaches window-side references before ClearChildren() releases the shared pointer, and ~UIElement remains the fallback. UIA providers now call UiaDisconnectProvider before release, fixing the AV and CFG FAST_FAIL_GUARD_ICALL_CHECK_FAILURE crashes after list/member rebuilds.
  • TreeView column width: added SetStretchLastColumn(bool) / GetStretchLastColumn() (default on); when total content width is narrower than the viewport, the last column receives the remaining width, fixing Chinese labels truncated to ... by the 40px minimum column width.
  • R7 selection consistency: ListView GetSelectedIndices now includes selectedIndex_; SelectAll/toggle/shift/marquee emit multi-selection signals; clear APIs clear current state. TableView gained SelectAll, GetSelected* includes the current cell, and clear/marquee emit signals. TreeView SetSelectedNode replaces instead of accumulating in multi-select mode.
  • ViewCore scaffolding: added viewcore::ScrollAxis/ScrollViewport, RecyclePool<T> and FetchFlow<Result>; ListView now uses ScrollAxis for vertical scroll state and has SetItemProvider(count, fetch) and SetAsyncItemProvider(count, fetcher) for virtual text; the demo exercises 200k pseudo-random rows asynchronously.
  • SplitView: expand buttons now follow the splitter direction; when both minimum sizes cannot fit, the button stays visible but is greyed out and non-interactive. Added SwitchToFirst/Second/Pane full-pane slide transitions (PageHost-style easing); they play even when both panes cannot fit and commit the collapse state with ActivePaneChanged when finished.
  • Async tasks: added RunAsync<T> / AsyncTask / AsyncCancelToken / AsyncProgress / AsyncOwner; background execution, cooperative cancellation, coalesced UI progress, ordered completion/failure/cancel callbacks on the UI thread, and callback drop after the weak owner expires; added basic, exception, cancellation, lifetime, 1000 cancellation/completion races and 1000-task randomized stress self-tests.
  • Image / window events: Image::FromHBITMAP reads 32bpp DIB pixels and preserves alpha (optional premultiplied flag); Window::SizeChanged / DpiChanged added; multi-select and HBITMAP-alpha self-tests added.
  • SplitView collapse/drag: unified ClampFirstLen, fixing minimum-width conflicts, reverse drags and expansion with insufficient space; added insufficient-space default-side/auto-collapse configuration.
  • TrayIcon: handles both NOTIFYICON_VERSION_4 and v3 WM_LBUTTONUP/WM_RBUTTONUP/WM_LBUTTONDBLCLK fallbacks, fixing unresponsive left/right click and hover; added SetClickImmediate.
  • Drawer: on close completion, recursively invalidate content layout and repaint, fixing stale content after clicking the overlay scrim.
  • Card: content measure/arrange now includes the child layout margin, fixing ignored top/bottom margins in Card → ColumnBox.
  • TextBox password field: added a vector eye button on the right in password mode; hidden by default, click toggles plain/masked text; added TogglePasswordReveal and SetPasswordRevealButtonVisible.
  • MessageBox: compute content size and call SetSize before disabling resize, so WM_GETMINMAXINFO no longer clamps the height and clips the bottom button; measurement width now subtracts the root margin.
  • Verification: x64 Release + ZufyUIDebugger build; full self-test (including 1000 cancellation races / randomized stress) passes.

2026-10-31 — Menu/title-bar/resize fixes and independent render thread disabled (v1.27.1)

  • Independent render thread: disabled and cleaned up the experimental ZUFYUI_RENDER_THREAD path; stable single-thread rendering and the VBLANK frame-sync code remain. README/API no longer expose the experiment.
  • Context menu: non-DWM chrome popups skip DWM frame/corner processing, use no rounding and no DWM border, removing the extra border around menus.
  • Top menu bar: closing a menu now clears both openIndex_ and hoverIndex_, preventing a stale half-hover/open highlight.
  • Title bar: AdvanceFrame uses the title bar's actual IsVisible() state; SetTitleBarVisible(false) clears the title-bar height and invalidates layout immediately, fixing menus pushed down after hiding the title bar or returning to the native frame.
  • Resize: after WM_SIZE resizes the swap chain it now submits a frame immediately, and Present1 does not wait for vblank while dragging, avoiding a layout that is already new while the picture is stale/transparent.
  • Verification: x64 Release + ZufyUIDebugger build; 280 self-test checks pass.

2026-10-29 — Windows 10 backdrop/frame, Snap, render driver and API cleanup (v1.27.0)

  • Windows 10 Acrylic: enable ACCENT_ENABLE_HOSTBACKDROP before creating the HostBackdropBrush, preserving the custom blur/saturation/tint/noise chain; stop writing Win11-only DWM attributes on Win10, avoiding the gray translucent result and lost border/shadow.
  • Custom frame / Snap: keep DwmExtendFrameIntoClientArea({1,1,1,1}) for custom frames on both Win10 and Win11; reapply frame state after WM_SIZE, WM_WINDOWPOSCHANGED, and backdrop reloads, fixing lost borders/shadows after Win11 Snap.
  • Title bar: Windows 10 caption glyphs fall back to Segoe MDL2 Assets; the maximize/restore button refreshes after system Snap, title-bar double-click, Win+Up, etc.; UI animation updates pause during drag/resize so low-end devices stay responsive.
  • Render driver: added RenderDriver, SetRenderDriver(), GetActiveRenderDriver() and GetRenderDeviceName(); Auto prefers hardware and falls back to WARP. The demo supports --warp / --gpu and a restart-based home-page switcher, with the status bar showing the actual driver/adapter. WARP changes only application content rendering; DWM/Compositor may still use the GPU.
  • Breaking API cleanup: removed public WindowCorner, SetWindowCorner(), GetWindowCorner() and DSL corner(). Win10 stays square, Win11 follows DWM; custom corners require calling Win32 DWM APIs directly and accepting the risks.
  • Verification: Win10/Win11 normal windows, Snap 1/2 and 1/4, maximize/restore; x64 Release build passes, 280 self-test checks pass.

2026-10-27 — Layout measurement contract, UIA lifetime fix, control polish (v1.26.0)

  • Layout · explicit size contract: an explicit GridLayout width/height now also constrains cell measurement, so it no longer reports 260 while arranging rows at 274+; RowBox/ColumnBox allocate finite main-axis space to Fill children; Card/Page/ScrollViewer honour explicit sizes with no content; Button measures its content even with autoSize disabled; Label explicit width participates in wrapping; TabView tab Labels are measured during Measure and arranged in Arrange/Update; ScrollViewer no longer re-measures content in Arrange.
  • UIA · CFG crash fix: the minidump confirms c0000409 + Subcode 0xA FAST_FAIL_GUARD_ICALL_CHECK_FAILURE (not Stack Cookie/TDR). UiaContexts now uses shared contexts, all UIA context/provider caches share a recursive lock, providers no longer keep raw contexts, ReleaseAccessibility/ForgetAccessibleElement are serialized with callbacks, and notification paths keep providers alive. Verified with 100 UIA tree walks + 300 ElementFromPoint queries.
  • Expander: content is measured once even while initially collapsed; expanded content always stays in childrenView_, so collapse/re-expand no longer loses it; animation no longer calls SetHeight/duplicates invalidation every frame; content clipping keeps at least a 4 px bleed; fixes first-expand right-shifted text and clipped drop-downs.
  • ToggleSwitch: click toggles on mouse-up; press-drag left/right makes the knob follow the pointer and commits by drag progress; mouse capture; default animation duration 0.18 s.
  • Slider: added GetDisplayValue(); normal dragging is immediate, while clicking the track or snapping eases the display value; UIA RangeValue retained.
  • Demo: layout-stress page fixes for Grid height/input-row width/label wrapping; added the "all controls" page; HwndView overlay is hidden by default with a toggle.
  • Docs: API zh/en synced (Grid/Expander/ToggleSwitch/Slider/UIA); README history and feature bullets; AGENTS records the layout/UIA/animation/crash-code lessons.
  • Verification: x64 Release build passes; ZufyUI self-test 280 checks pass; UIA stress queries pass.

2026-10-25 — Drawer side panel, temporary key handlers, signal tests (v1.25.0)

  • New · Drawer: left/right/top/bottom × Overlay / Push / Permanent. Overlay uses a rounded scrim; Push makes room; Permanent stays open with no animation/scrim and ignores Close. Rounded panel, border, and a real outer shadow (shadow first, opaque panel background covers its inner layers, border painted last).
  • New · Window::AddKeyHandler / RemoveKeyHandler: temporary window-level key handlers, called after OnWindowKeyDown and before the focused element; Drawer uses one for Esc while open and removes it on close/detach/destruction.
  • New · Drawer demo: side/mode selectors, open/close, panel-top X, search/category/active-only/result count/filter list; content includes BarChart, Slider, Toggle, CheckBox and ListView.
  • Improvement · ScrollViewer bleed: content clip bleed follows GetBleed() (default 4px) instead of a fixed 1px, so control borders/shadows inside the drawer are not clipped.
  • Tooling · test rename: tests/dsl_tests.cpp → tests/zufyui_tests.cpp, tools/run_dsl_tests.ps1 → tools/run_tests.ps1.
  • Tests: signal reentrancy/slot exceptions/NewThread weak keep-alive/UIThread cancellation, Drawer layout/animation/scrim/Push/Permanent/vertical sides; ZufyUI self-test 213.
  • Demo default backdrop: reapply Acrylic after Show() so the first DWM application always takes effect.
  • Verification: x64 Debug/Release and x86 Release builds pass; 213 self-test assertions pass.

2026-10-25 — Signal lifetime, receiver context, ConnectWeak (v1.24.0)

  • Breaking · ZSignal is non-movable: removed its move constructor/assignment; signals are control/window members, so do not put them in movable containers. Old code that moves a ZSignal now fails to compile.
  • Breaking · member-function pointer connections: elem->Connect(sig, &Class::Method) is no longer supported; use Connect(elem, sig, &Class::Method) (compile-time checked) or ConnectWeak(elem, sig, &Class::Method).
  • Breaking · Connection semantics: disconnect() now logically cancels pending UIThread / NewThread tasks; it does not interrupt a slot already running.
  • Fix · signal liveness race: ConnectionState::alive is now atomic; disconnect runs its internal removal callback under the state lock; signal destruction kill()s states before releasing them, fixing the alive data race and the check-then-call UAF.
  • Fix · queued tasks: UIThread / NewThread tasks capture the connection state and check liveness before running; they no longer execute after receiver destruction or a manual disconnect.
  • New · receiver context: a ConnectionOwner base class; UIElement / Window derive from it. elem->Connect(...), free Connect(elem, ...) and sig.connect(elem, ...) follow the receiver's lifetime, not the signal owner's.
  • New · ConnectWeak: weakly-referenced receiver; the slot's first parameter is T* / T& or a member-function pointer; the receiver stays alive while the slot runs, and the slot is skipped after destruction. Useful for NewThread or uncertain lifetimes.
  • Improvement: Window's ReloadAcrylic / ThemeChanged / ThemeReapply global connections now go through Window::ConnectionGroup; manual Connection members were removed. ConnectionGroup::size() counts live connections only and periodically prunes dead weak references.
  • Scope: Menu / MenuItem / Timer still use signal.connect and do not auto-disconnect.
  • Tests: ZufyUI self-test 140 → 175; added receiver-destruction disconnect, free Connect, ConnectWeak, Connection copy/move, signal-destroyed-first, reentrancy, slot exceptions, NewThread weak keep-alive and UIThread cancellation regressions.
  • Verification: x64 Debug/Release and x86 Debug builds pass; DSL 175 assertions pass. x86 Release was not rerun this round.

2026-10-23 — Button rich content/split, SetBackdrop fix, ListView division (v1.23.3)

  • New · Button rich content: the internal Label is a real child now, so GetLabel()->AddChild(...) is laid out/composited/drawn; SetContent(shared_ptr<UIElement>) / ClearContent() replace the content entirely.
  • New · Button drop 2x2: SetDropWriteBack(bool) x SetDropOpenOnClick(bool). A button click always fires Clicked; when opening, the callback runs first, then the menu appears. The menu is single-select (the previous choice is marked); selecting fires DropSelected(index), readable via GetDropSelectedIndex/GetDropSelectedText; SetDropItems builds a text list, SetDropMenu accepts a custom menu, and ShowDropMenu() opens it when DropOpenOnClick=false. The menu appears below the button without a MessageBox.
  • Fix ? drop-menu position: GetDpiScale() returns 96/144 (not 1.0/1.5); the old multiplier sent the menu to the screen bottom-right. Dividing by 96 places it under the button, and the demo no longer shows a MessageBox on split click.
  • Fix · SetBackdrop: with no explicit tint, SetBackdrop(Acrylic/Mica) no longer applies an opaque white overlay (the old default backdropFollowAlpha_=0xFF covered the system material); None keeps the opaque white default, and explicit tints (including alpha) are preserved. Added GetBackdropColor() for diagnostics.
  • Fix · ListView: SetItemHeight is clamped to >=1px; Draw / hit-testing guard against a non-positive row height, avoiding the SetItemHeight(0) divide-by-zero and int conversion UB.
  • Docs/cleanup: documented the HwndView cross-process SetParent risks (input queue coupling, blocked messages, intermittent instability); removed the redundant WM_ACTIVATE check; added <cstring> to ZDataViewer.h; removed the demo's empty ScrollChanged callback.
  • Demo: the buttons page now shows a rich-content button and a split button.

2026-10-22 — Debug builds: add /bigobj (v1.23.2)

  • Build: added /bigobj to the Debug|Win32 and Debug|x64 configurations of ZufyUI.vcxproj / ZufyUIDebugger.vcxproj (Release already had it). Full Debug builds previously failed in ZufyUI.cpp / ZufyUIDebugger.cpp with C1128: number of sections exceeded object file format limit.
  • Verification: Release / Debug × x64 / x86 demo + Debugger + ZufyUI self-test all pass.
  • Docs: README / AGENTS / API now document the ASCII-only export and the encoding rule; dist/ascii is gitignored and never committed.

2026-10-22 — PageHost page measurement + docs & tooling (v1.23.1)

  • Fix (layout / hit-testing): PageHost used to only Arrange its pages and never Measure them, while Page::Arrange re-measures only when the arranged size changes. When a page element becomes visible at runtime (typically an Expander card shown by SetVisible(true) after a combo-box selection), the dirty measure never reached the page → the newly shown element kept a zero desiredSize/arrangedRect → it was drawn but had no border and failed HitTest, until the user resized the window (a size change) once. PageHost::MeasureOverride now measures every page; clean pages hit the Measure cache, so no duplicate work is added.
  • Docs: the README first screen now leads with positioning, differentiators, the Release link, a screenshot and a one-line experimental note; the full feature list is collapsed; added issue/PR templates; sources moved to docs/src/ with a new docs/README.md; Chinese and English first screens aligned.
  • Engineering: ZufyUIDebugger moved into this repository and the solution; tools/build.ps1 / run_tests.ps1 locate Visual Studio via vswhere (no hard-coded paths) and map x86 to the Win32 output correctly; added tools/export_ascii.py (ASCII-only, BOM-free export), tools/build_docs.py (ZufyUI docs wrapper) and tools/make_icon.py (icons: docs/icon.* plus the app icons ZufyUI.ico / small.ico).
  • Docs tooling: the generic md2html no longer probes for ZufyUI; it accepts --var KEY=VALUE and --icon; ZufyUI version/icon injection lives in tools/build_docs.py.
  • Repo hygiene: TODO.md is no longer published (removed from the index and gitignored); dist/ build outputs are ignored.

2026-10-13 — Native window host, external visual attachment, overlay sync/performance, NumberBox error state, data-view fill (v1.23.0)

  • New: ZufyUIHwndView.h (HwndView) — embeds a WebView2 HWND controller / camera / third-party control / out-of-process window into the layout. The host is a top-level owned popup; the external HWND is embedded as a WS_CHILD (cross-process allowed). Moving the host moves the child natively; clipping = host client + SetWindowRgn (element rect ∩ window client ∩ ancestor GetClipRect).
  • New: Window::CreateExternalVisual / SetExternalVisualBounds / RemoveExternalVisual (a WinRT ContainerVisual attached to the root visual, for WebView2 CompositionController / video); Window::AddOverlaySync / RemoveOverlaySync / SyncOverlays (unified overlay sync).
  • Performance: overlay sync is a single window-level point (WM_MOVE/WM_SIZE/WM_DPICHANGED immediate + one shared 16ms fallback), removing per-instance timers; DPI/client cached; redundant SetWindowPos skipped and SWP_NOSIZE/NOMOVE used as appropriate; the demo's color pattern is cached into a DIB.
  • Fix (NumberBox): a valid number clears the empty-text error state; ResetToDefault force-clears the error after notifying the app; step/clear buttons fire on press (no second rect check).
  • Fix (data views): ListView/TableView/TreeView MeasureOverride honours SetFillWidth/SetFillHeight.
  • Demo: new "Native HWND" page (GDI color pattern + multiple layouts + an out-of-process --outproc window hosted by HwndView).

2026-10-13 — Tier 0 fixes: layout overflow/alignment, IME, accessibility, visuals/engineering (v1.22.1)

  • Fix (layout): RowBox/ColumnBox didn't clamp each child's base to min/max → a child with SetMinWidth/Height pushed its extra space onto a stretching sibling and overflowed the row/column (the slider spilling outside its card). Now base = clamp(base, min, max).
  • Behaviour: ColumnBox/RowBox/GridLayout no longer shrink content — overflow is left to an outer ScrollViewer.
  • Fix (alignment): GridLayout's SetHorizontalAlignment/SetVerticalAlignment used .empty() (always false) → never applied; now checks "all zero", so Center/End work.
  • Fix (text/IME): TextBox/TextEdit merge UTF-16 surrogate pairs (emoji / beyond-BMP) and insert them as one unit; cursor/backspace/delete span the whole pair; on losing focus the control clears its own composition state and Window::ResetImeState() cancels the program-side IME composition. SetImeEnabled(false) also clears composition.
  • Fix (accessibility): GetAutomationIdOrAuto() now uses a per-window counter (no cross-window collisions); ElementProviderFromPoint descends child-before-parent to the deepest hit.
  • Fix: data view item/cell bleedY reads each element's GetBleed(); indicatorY_ initialised to -1 (indicator snaps on frame 1); focus ring uses ThemeRole::FocusRing + Theme::cornerRadius; title-bar buttons take priority over the resize border in WM_NCHITTEST (Snap Layouts can appear).
  • Engineering: pch.h no longer includes the library headers; added UIElement::MarkUserColor(); removed dead ListView::FindEnabledFrom.
  • Docs: docs/API.md/API.en.md, docs/pitfalls.md, AGENTS.md synced.

2026-10-12 — API debt cleanup (P0–P3): .with usability, collision-free factories, RAII theme hooks, one-line scrollable page (v1.22.0)

  • Breaking · member functions with default arguments split into non-defaulted overloads (so .with() is usable): TreeView::SetCheckable(bool) + SetCheckableShallow(bool); SetNodeCheckable + SetNodeCheckableRecursive; SetNodeEnabled + SetNodeEnabledRecursive; SetNodeCheckState + SetNodeCheckStateFull; ListView::AddItem(text) and rich-item AddItemWidget(shared_ptr<Label>); RadioGroup::AddItem / AddItemSelected / AddButton / AddButtonSelected; Menu::AddCheckItem / AddCheckItemCb / AddCheckItemRadio.
  • New · collision-free aliases for name-clashing factories: make_slider / make_card / make_page / make_menu / make_menu_bar / make_status_bar / make_radio_group / make_scroll_bar / make_expander.
  • New · Page::SetScrollableContent(content) — one line wraps the whole page in a ScrollViewer + margin.
  • New · ThemeManager::RegisterHook/RegisterSubtreeApplier return a RAII HookHandle (auto-disconnect on destruction); the library's fixed hooks use RegisterHookPermanent.
  • New · docs/pitfalls.md; AGENTS.md gained a "chaining / API conventions" section.
  • Fixes: MessageBox (and modals) first-click fall-through (ReleaseCapture before RunModal); ScrollViewer scroll chaining (no wheel swallowing at the edges); SplitView expand had no easing + button jumped sides.
  • Docs: docs/API.md/API.en.md synced.

2026-10-12 — Feedback batch: SplitView collapse, rendering/layout fixes, demo home page + menu/status bar (v1.21.0)

  • New · SplitView collapse: drag the splitter to within a threshold of one side's edge and a translucent accent overlay plus a direction arrow fades in on top of that pane's content (alpha fade, the content is not changed yet); the pane only collapses on release (its size eases to 0). Once collapsed, a small button appears at that edge (rounded light grey + arrow pointing in the expand direction + hover easing); clicking it eases that side to its minimum limit. Turn the whole feature off with SetCollapseEnabled(false); new CollapsedChanged(int) signal plus CollapseFirst/CollapseSecond/Expand/IsFirstCollapsed/IsSecondCollapsed and friends.
  • New · one animation convention: detail::EaseOutCubic/EaseInOutCubic (duration-driven, stops exactly on time). ToggleSwitch now uses ease-in-out (DefaultAnimationDuration = 0.25s, and fixes "click/keyboard bypassed SetOn so the animation never started = instant snap"); ProgressBar values are eased (DefaultValueAnimDuration = 0.22s).
  • Fixes · rendering: Card flashed a blue hover border (the theme set a hover border colour on cards, which cards never had); ProgressBar's inner fill radius no longer matched the outer frame after stretching (track/clip/border still used the construction-time height).
  • Fixes · layout: Button captions were ellipsized even with room to spare (width was a constant DefaultWidth; it now grows to fit, and AutoSizeToText(false) opts out).
  • Fixes · charts: PieChart's zoom_ shadowed ChartBase::zoom_, so Ctrl+wheel zoom did nothing (the pie now handles Ctrl itself); wheel panning "did not move" (the pan path was missing SyncScrollPositions()). Semantics are explicit: Ctrl+wheel = zoom / plain wheel = pan only.
  • Docs: added two pitfalls — "ColumnBox arranges a child without an explicit width at the available width (horizontal stretch ignores the weight), so wrap a card in a Row to make it hug its content" and "a SettingsList inside a Card's built-in GridLayout degenerates to zero width"; ThemeRole::Shadow (appended at the end of the enum) and Window::SetBackdrop(Backdrop) following the theme.
  • demo: new home page (settings-card navigation that jumps to each page); the multi-window page became 7 collapsible cards; the menu bar grew to 6 menus (with sub-menus that really change state: jump to page / backdrop / window size / frame-rate limit); the status bar became 5 live panels (page / theme / backdrop / DPI·client area / window state, refreshed by theme switches and window signals); every MessageBoxW was replaced by the library MessageBox with click feedback on all buttons; duplicated boilerplate removed (14 section helpers, 7 accent helpers, 14 Scroll wrappers → 3 shared helpers).
  • Self-tests: tests/zufyui_tests.cpp 62 → 85 assertions (including regressions for this batch).

2026-10-11 — DSL polish + one-shot build script + null/self-containment fixes (v1.20.0)

  • DSL: root() now accepts any Layout subclass (Row/Grid did not even compile before, because Ref → shared_ptr<Layout> needs two user-defined conversions); add() dispatches on the container's real API; GridLayout gains Cell(row,col,child[,rowSpan,colSpan]) coordinates; added apply()/Wrap(), a batch of layout/size/weight/colour/spacing/alignment shortcuts, plus RadioGroup()/ScrollBar()/Glyph() factories and data-view & menu builders.
  • DSL: WindowApp::run() now calls Show() (Window::Create does not show the window, so the old code ran a message loop with no window); added hidden/minSize/position/frameRateLimit/theme/useAppTheme/dropTarget/icon/titleBarVisible/showTitleText/menuBarInTitleBar and the window signal hook on<&Window::Closed>; WindowApp is now movable.
  • Fixes: null guards in ColumnBox/RowBox/GridLayout::AddChild (the DSL's variadic forwarding can pass nullptr).
  • Fix: ZufyUIWindowTool.h now includes ZufyUIWidgets.h — it used Label/Button while depending on the caller to include it first.
  • Tooling: new tools/build.ps1 (one shot: auto-fix BOM before building → kill processes holding files → build demo + ZufyUIDebugger → run self-tests), tools/ensure_bom.ps1 (BOM guard), and tests/zufyui_tests.cpp + tools/run_tests.ps1 (47 assertions, no window needed, runnable from a shell or CI).

2026-10-11 — Theme system + fluent DSL + card/drag-drop controls + fixes (v1.18.1 → v1.19.7)

  • v1.19.0: Charts ZufyUICharts.h (BarChart/LineChart/PieChart); TextEdit editor; drag & drop ZufyUIDragDrop.h + card controls Expander/SettingsList; ComboBox rotating arrow.
  • v1.19.1: TextEdit standard undo/redo (restores selection/cursor); drag fixes (drop caret, keeps source selection); ScrollViewer measured at viewport width + 1px bleed; Label::SetImageFit (standalone ImageView removed).
  • v1.19.2: MenuBar top menu + StatusBar bottom bar (overlaid on the custom title bar by default).
  • v1.19.3: theme system (Theme/ThemeRole/ThemeManager; light/dark/high-contrast; follows system light/dark + accent; explicit instance colors win); UIZSignals::ThemeChanged/ThemeReapply.
  • v1.19.4: fluent construction DSL (ZufyUIDsl.h); fixed clipped CheckBox label; ListView/TableView cache collapsed into a single ChildrenSig(); ChartBase fill fallback.
  • v1.19.5: DSL enhancements — dsl::App() window builder + SFINAE per-control sugar + chart composition.
  • v1.19.6: fixed ListView button-mode checkbox hit off by 4px and Label wrap ignoring inline children width; version is now a single source (generator injects 1.29.1) + doc cleanup.
  • v1.19.7: audit fixes (chart scrollbar allowance, NumberBox wheel, anim-set dangling, Menu::ShowAt exception, layout spacing, data-view child label release, IME association, etc.); added TODO.md merging the former plan files.

2026-10-06 — Docs & images update (v1.18.1)

  • Re-shot and updated the README "Quick start" images (quickstart / backdrop / custom title bar / overview).

  • README step 3 example now also sets the Mica backdrop (SetBackdrop(Backdrop::Mica, ...)), so the custom title bar stands out.

  • Added docs/diagrams/: screenshot program screenshots.cpp + image manifest (with text-form diagrams — keep images to a minimum).

  • Library version macro bumped to 1.18.1.

  • Version 1.18.0 → 1.18.1.

2026-10-05 — Charts (BarChart/LineChart/PieChart) + multi-line editor TextEdit + fixes & docs rework (v1.18.0)

New: Charts (new header ZufyUICharts.h)

  • ChartBase: data/multi-series, "nice" ticks, category axis, grid, legend, palette, internal scrollbars, sticky axes, Ctrl-zoom, drag-pan, entrance animation, horizontal/vertical reference lines; UpdateSeriesValues refreshes live without replaying the entrance animation.
  • BarChart: Grouped / Stacked / PercentStacked / Overlapped, horizontal orientation, per-bar colors, selection highlight, outline, corner radius; SetFitPlotSize makes the value axis fill the control.
  • LineChart: straight / smooth / dashed lines, markers, area fill (baseline clamped into the visible range), hover/click.
  • PieChart: pie/donut, labels + leader lines, legend, hover pop-out, full-circle sweep-in, wheel zoom (SetZoom).
  • See the "Charts" chapter of the API doc.

New: multi-line editor TextEdit (ZufyUIWidgets.h)

  • QPlainTextEdit-style: line numbers, wrap (WrapMode), Tab indent, cross-line selection, clipboard, undo/redo, find, read-only rich text (TextRun); auto-hiding internal scrollbars; IME candidate rect; UseCache()=false.
  • New base virtual UIElement::AcceptsTab() (multi-line editors consume Tab for indent instead of changing focus).

Fixes

  • Memory churn on rapid page switching: PageHost now releases a hidden page's cache after a grace period (~1.2 s, recursively over the whole subtree; reuses it if switched back in time) instead of allocating/deleting bitmaps every switch. New UIElement::ReleaseDeviceResourcesRecursive().
  • View not repainting while the scrollbar expands/shrinks: ScrollBar now also repaints its host when its animation progresses.
  • Line chart freezing during the 2 s idle-shrink wait: the idle-shrink countdown is no longer reported as an active animation (which had put the whole window into animation mode and stopped data repaints from landing); idle shrink is now lazy (triggered by the next frame).
  • ScrollViewer offscreen cache: switched to UseCache()=false (content changes/scrolls; the cache costs a large bitmap for no benefit); SetUseCache(false) now immediately frees an existing bitmap.
  • Snap's DPI scale is now also set on the UI thread (Window::Create / WM_DPICHANGED), fixing hit-test vs. render snap mismatch at non-100% DPI.
  • ZSignal::Fire exception safety (RAII guard); TextBox shift+click extends from the anchor; TextEdit::SetCursorImpl duplicate statement removed; Slider zero-width NaN guard; ListView pooled-label re-measure on width change (fixes stale ellipsis).

Docs

  • API docs reorganized by usage category (zh + en): new chapters "Charts", "Accessibility & Debug Channel", "Version Digest", "Pitfall Index", "Appendix"; every API now carries 易错 (pitfall) and 版本 (version) notes.

  • Version 1.17.0 → 1.18.0.

2026-10-04 — UIA accessibility + external debug channel + layout stretch weights + fixes (v1.17.0)

Accessibility (UI Automation, ZufyUIWindowTool.h, on by default)

  • Window::SetAccessibilityEnabled (default true): the window exposes a UIA provider (IRawElementProviderSimple/Fragment/FragmentRoot) via WM_GETOBJECT.
  • UIElement API: SetAccessibleName/Description/AutomationId/Role, GetAccessibleName/Role, GetAccessibleChildren, IsAccessibilityIgnored, GetAutomationIdOrAuto() (auto e{n} when unset).
  • Controls expose patterns by role (Invoke / Toggle / Value / RangeValue / ExpandCollapse); AccessibilityNotify* for manual updates; SetText/SetChecked/SetOn auto-raise property changes. AccessibleRole enum.
  • Window::GetFocusedElement/GetHoveredElement/GetPressedElement/FocusElement/HitTestElementDIP/ForgetAccessibleElement.

External debug/automation channel (ZufyUIWindowTool.h, off by default)

  • ZufyUI::SetDebugEnabled(bool) / IsDebugEnabled(): the target window then answers WM_COPYDATA (dwData = 0x5A554631), replying to wParam. The library does no file I/O — current-frame info only.
  • Commands: 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 (repaint/layout/cache/draw) / 19 ResetCounters / 20 SetVisible / 21 SetMargin / 22 SetHighlightColor; highlight color customizable (green by default).

Layout stretch weights

  • ColumnBox / RowBox now distribute leftover space by child stretch weight (SetVerticalStretchWeight / SetHorizontalStretchWeight, or SetFillHeight / SetFillWidth); no longer keyed on type defaults.

Misc

  • Auto ToolTip for clipped text: Label (when Ellipsis-truncated) shows the full text on hover; Button delegates to its inner Label.

  • Custom title bar: CaptionButton::Kind::Pin (client toggle, always-on-top) + TitleBar::AddCustomButton.

  • TreeView: TreeNode::bgColor row background + GetScrollOffsetY/SetScrollOffsetY.

  • Window::DefaultBackdropColor defaults to pure white (0xFFFFFFFF).

  • Version 1.16.0 → 1.17.0.

2026-10-03 — Render thread off by default + system dialogs (file/folder/color) + stability fixes (v1.16.0)

Independent render thread now off by default

  • ZUFYUI_RENDER_THREAD defaults to 0 (single-threaded WM_PAINT, stable). The mechanism is currently unstable and buggy (blank popups, delayed hover/tooltip and nested page switches, occasional crashes with large data, ...) and is not recommended; set it to 1 only if you really need vblank-level smoothness and can afford the debugging cost. Noted in README / API docs.

New system dialogs (ZufyUIWindowTool.h)

  • File / folder: FileDialog (modern IFileOpenDialog / IFileSaveDialog) — supports type filters (multiple FileFilter groups), multi-select, folder picking, save-as, initial directory / default name / default extension; Open / OpenFiles / PickFolders / Save + *One convenience + FilterLabels.
  • Color: ColorDialog::Pick(owner, initial, opts) (ChooseColor) with preset custom colors.
  • Opt-in macro ZUFYUI_ENABLE_COMCTL_V6: when defined, the library injects the Common Controls v6 manifest dependency (ChooseColor / MessageBox get themed). Because the manifest is application-wide, it is off by default and left to the application.

Stability / correctness fixes

  • Render-thread structure: Present1 moved out of renderLock_ (a gpuLock_ guards swap chain / device resources); PageHost transition state / pages_ mutations now locked; popups render synchronously on first show via RenderNowSync; new library error signal UIZSignals::Error (menu/window/composition-backend creation failures are reported, not silent).

  • Cursor: added "desired cursor" tracking; WM_SETCURSOR re-applies it per hovered element, fixing the flicker where a control's own cursor was repeatedly reset.

  • Hover pass-through: while a menu is open or input is modal-blocked, main-window elements no longer hover.

  • TreeView first column: when space is tight, hide icon / checkbox / triangle in order and clamp the text start into the column so the text ellipsizes (instead of disappearing).

  • TrayIcon: callback message no longer collides with WM_RENDER_TICK; MenuWindow creation failures are no longer silent.

  • Version 1.15.0 -> 1.16.0.

2026-10-03 — Data-view virtualization + cross-thread concurrency hardening (v1.15.0)

Data views (ListView / TableView / TreeView) virtualization

  • Now viewport-virtualized: cell labels are created / arranged / drawn only for visible rows (pooled label reuse), so millions of rows no longer blow up the visual tree. ListView / TableView gain:
    • Hide: SetItemHidden / IsItemHidden / ClearHidden;
    • Filter: SetFilter(pred) (predicate takes the source row) / ClearFilter;
    • View-order sort: SetViewComparator + SortView / ClearViewSort;
    • Two coordinate systems: VisibleCount / SourceOfVisible / VisibleOfSource / TextAtVisible / SetSelectedVisible / GetSelectedVisible (visible order); every other existing API keeps using the source row.
  • ListView data API unified to *Item* (SetItemCount / SetItem / AddItem / SetItemHidden / SetItemToolTip / GetItemText, ...); the duplicate *Row* forms were removed.
  • TreeView: new BeginUpdate / EndUpdate (rebuild the visible list once, removing the O(N^2) cost of adding nodes one by one), SetNodeText / GetNodeText (write a cell by column; empty slots auto-create a Label), SetNodeTooltip / GetNodeTooltip.
  • GetChildren made read-only: every container now rebuilds its child list in the update phase via RefreshChildren(); GetChildren() just reads — the render thread no longer mutates the element tree while rendering.

Cross-thread concurrency hardening (independent render thread, arch B)

  • Window-destruction UAF eliminated: a liveness token (alive + inFlight) that lives outside the window's memory. The render thread pins before each batch; destruction sets alive=false then waits for inFlight to reach 0 (via condition_variable, no busy-spin) before tearing anything down.
  • ComboBox / TabView / TreeView input/data mutations now hold renderLock_; added the lock to Window::OnMouseUp (fixes the hover-animation-field race via UpdateHover -> OnMouseEnter/Leave).
  • g_imageDeviceEpoch / frameRateLimit_ / windowId_ made atomic; AppCore's window registry guarded by a shared_mutex; WM_SIZE resize packed into a single 64-bit atomic; ~UIElement unregisters from the pending-repaint set; font cache is now event-driven (GetFontFormat fast path is lock-free, no per-frame wstring copy); ComboBox::overlayConn_ disconnect moved to the UI thread.
  • Lost-wakeup fix: renderRequested_ is cleared after a frame is processed and re-armed once, removing the "debounce window drops a wake -> wait one extra frame for WM_TIMER" case.

ComboBox fixes

  • Dropdown geometry unified (UpdateListGeometry, shared by UI and render): hit-testing / arrow direction no longer use a stale previous-frame value.
  • Disabled state survives filtering (stored by source index internally); added source-index selection API SetSelectedSourceIndex / GetSelectedSourceIndex / SourceIndexOf.

Other fixes

  • TreeView: Clear() resets the visible-index map; GetNodeAtY no longer mis-hits the header; VK_UP/DOWN wrap at the ends; column layout tracked by a version counter (no per-frame column signature); the root arrow and its hit region agree when rootDecorated_=false.

  • TabView: AddTab/InsertTab/RemoveTab/ClearTabs now emit SelectionChanged when the selection changes.

  • TextBox::Copy/Paste open the clipboard with the owning window's HWND.

  • Version 1.14.2 -> 1.15.0.

2026-10-02 — Fix A1 double-drive (doubled CPU/GPU) + A3 frame-rate cap (v1.14.2)

  • Fix (critical): A1's vblank tick and the old WM_TIMER -> HasRenderWork -> InvalidateRect -> WM_PAINT path were both driving frames during animation, each triggering AdvanceFrame + RequestRender -> potentially two frames per vblank -> doubled GPU/CPU (this was the "smooth but more expensive" root cause). Now, while animating, WM_TIMER yields to the tick and no longer calls InvalidateRect; non-animation work (tooltip / title polling / one-off repaints) still goes through WM_PAINT.
  • A3 frame-rate cap: Window::SetFrameRateLimit(fps) / GetFrameRateLimit(), plus static Window::SetDefaultFrameRateLimit(fps) / GetDefaultFrameRateLimit(). 0 or unset = follow the display refresh (default, no behavior change); >0 caps the average animation frame rate. Implemented with detail::NowMs() (QPC monotonic ms) + detail::PreciseSleepMs() (high-resolution waitable timer, falls back to Sleep) to pad the interval before composition. The demo now has win.SetFrameRateLimit(0); (change to 60 to test the lower load).
  • Version 1.14.1 -> 1.14.2.

2026-10-02 — A1 frame pacing: drop the WM_PAINT round-trip for animation continuation (fixes 120/60 jitter) + restore the indeterminate ProgressRing demo (v1.14.1)

  • A1 frame pacing (ZUFYUI_VBLANK_CLOCK, default 1): animation continuation no longer goes through ContinueFrame -> InvalidateRect -> WM_PAINT — WM_PAINT is only synthesized when the queue has no higher-priority message and can be delayed by input, which makes the frame-start time vary a lot -> 120<->60 jitter. Instead the render thread directly PostMessage(WM_RENDER_TICK)s the UI thread to run AdvanceFrame() (the "layout + animation + collect active animations" block extracted from OnPaint), debounced by frameTickPending_. Set to 0 to fall back to the v1.14.0 behavior.
  • Extracted Window::AdvanceFrame(), shared by WM_PAINT and the new tick; DwmFlush pacing is unchanged (present still aligns to vblank).
  • Restored the indeterminate ProgressRing (continuous spinner) on the demo "New controls B" page — mistakenly removed during the v1.14.0 phase-0 cleanup (it was a feature demo, not a temporary diagnostic).
  • Version 1.14.0 -> 1.14.1.

2026-10-02 — Independent render thread (arch B) + hover repaint optimization (v1.14.0)

Independent render thread (arch B)

  • Rendering is split off the UI thread: a process-level render thread handles composition / Present1 / the DwmFlush (vblank) cadence; the UI thread only does messages, input, layout and animation, and wakes the render thread via a coalesced RequestRender().
  • Shared device, per-thread context: the ID2D1Device and the DComp / swap chain are created on the UI thread; the render thread creates its own ID2D1DeviceContext; element caches move from ID2D1BitmapRenderTarget to device-scoped ID2D1Bitmap1 (two-pass: dirty caches are drawn on a separate DC first, the main frame only blits) — sharing across DCs works.
  • Cross-thread correctness: DC operations are serialized by renderLock_ (the tick stays outside the lock so the UI is never blocked); WM_SIZE only sets a pending flag and the render thread calls ResizeBuffers under the lock; WM_DPICHANGED rebuilds under the lock; device-lost goes "render detects -> pause render -> rebuild on the UI thread -> resume"; minimized windows emit no frames.
  • Compile-time switch ZUFYUI_RENDER_THREAD (default 1); set to 0 to fall back to the original single-threaded WM_PAINT path.

Hover repaint optimization (lower CPU)

  • Fixes "moving the mouse over the blank area of the button list (ListView) keeps burning CPU": the root cause was ListView::OnMouseMove calling RequestRepaint() unconditionally on every move (regardless of whether the hovered item changed, or whether it was blank) -> pendingRepaint_ was never empty -> full-window recomposition every frame.
  • Same fix for the ComboBox dropdown, DataViewer grid and TreeView: repaint only when the hover state actually changes (hover highlight behavior is unchanged).

Robustness

  • TabView / ProgressRing / SplitView Draw now guard against non-finite arrangedRect_, avoiding Direct2D geometry assertions from not-yet-laid-out / degenerate sizes.
  • Version 1.13.0 -> 1.14.0.

2026-10-01 — Menu rework: popup layer now derives from Window (fixes ~+90MB per open) + openable Window internals

Menu (major architecture rework)

  • Right-click / standalone / submenu popups now derive from Window (MenuWindowBase : Window + MenuWindow : MenuWindowBase) and use DComp + the process-shared D3D/D2D device — fixing ~+90MB per menu open (the old code used WS_EX_LAYERED + UpdateLayeredWindow + DIB + its own D2D factory/DC render target, i.e. a separate software render device per menu).
  • Soft shadow, rounded corners, fade-in, screen-edge avoidance, outside-click/Esc close, and the submenu open/close delay are all preserved.
  • Popups return WM_MOUSEACTIVATE → MA_NOACTIVATE and WM_NCACTIVATE → FALSE (refuse activation), so clicking them no longer makes the owner window receive a spurious WM_KILLFOCUS (the root cause of "clicking an item does nothing / just closes").
  • MenuWindowBase is subclassable → users can build custom flyouts (flyout / panel).

Openable Window internals (new)

  • Overridable creation parameters: GetCreateStyle / GetCreateExStyle / GetCreatePos / WantDwmChrome / WantBackdrop.
  • Message interception: OnWindowMessage (single entry; return true to swallow) + OnWindowMessageHandled (observe) + OnWindowClosing.
  • Self-draw: RenderContent(ID2D1DeviceContext*); SetContentOpacity (whole-window opacity, for popup fade).
  • Window is now subclassable (virtual dtor + the virtuals above).

Misc

  • Menu keyboard: ↑/↓/Home/End, Enter, Esc, ←/→ submenus, item shortcuts (Ctrl+C, ...); Tab closes the menu.
  • ToolTip: fixed "text drawn outside the box" (clamp the layout to the render target + ellipsis + clip).
  • Crash fix: a use-after-free when a menu item callback pops a modal (e.g. MessageBox) — Window::WndProc now has a self-destruct guard (the window object may be destroyed during HandleMessage, so afterwards it only checks the HWND and never touches self); menu item callbacks are deferred to after the current message is handled (detail::PostToUIThread, kept alive with shared_ptr), so they never run inside the message stack.

Data views / docs (v1.10.0)

  • Data views gain coordinate helpers ContentToLocalX/Y + LocalToContentX/Y (collapsing the scattered arrangedRect_.x - Snap(scrollOffsetX_) into one place).
  • Audited and confirmed: data-mutating methods (SetRowCount / SetColumnCount / row/column insert/remove / SetItem / AddItem, ...) already auto InvalidateLayout + RequestRepaint; containers' AddChild/SetParent auto-mark dirty — no manual MarkChildrenDirty needed.
  • Docs: added "Window lifetime and semantics" (Show / RunModal / owned / shared_ptr).
  • Version 1.9.6 -> 1.10.0.

Internal robustness / performance (v1.10.1)

  • Process DPI awareness moved to static-initialization time (before main, before any window) — it used to live in Window::Create with its return value ignored, so if the process created any other window first it would silently fail and every coordinate in the process would be wrong.
  • Window::Create gained x / y position parameters (default CW_USEDEFAULT; when omitted it can still be overridden by GetCreatePos).
  • ListView child cache now uses field-by-field comparison — the old float key (count*1e6 + rowHeight*1e5 + ...) had overlapping field ranges and lost precision past ~10k items.
  • TreeView::TreeNode::parent is now std::weak_ptr (weak ref breaks the cycle); checking walks the parent chain with lock(), dropping the per-level whole-tree FindNode (was O(n·d)).
  • System noise texture now caches the module handle + decoded WIC bitmap: a DPI change no longer re-runs LoadLibrary + WIC decode.
  • ImageDeviceCache::Get moves the GPU upload (CreateBitmapFromWicBitmap) out of the lock (double-checked).
  • ComboBox dropdown now connects to the global DrawOverlay on demand: collapsed combo boxes no longer run an empty lambda every frame.
  • Label::Draw / Label::MeasureOverride go through the FontManager layout cache (key now includes alignment / line spacing / max lines; the Ellipsis truncation result is cached by original text, so a hit skips the whole truncation computation). Highest-frequency widget path — biggest win in tables.

Stability fix (v1.10.2)

  • Text-layout cache accessors now return a strong ComPtr instead of a raw pointer. GetRawLayout / GetDisplayLayout / GetStyledLayout / GetStyledDisplayLayout used to hand back a raw borrow into the cache, and the bounded FIFO (cap 400, drops 1/4 at a time) could free that entry between "got the pointer" and "used it" -> dangling (surfaced as an access violation in Label::MeasureOverride -> GetMetrics under large tables + frequent refresh). The caller now holds a strong reference, so an evicted entry cannot invalidate the object.
  • FontManager's factory init, formatCache_, and layoutCache_ / layoutFifo_ are now guarded by a std::mutex (defends against any future cross-thread call).

Stability / robustness fixes (v1.10.3)

  • MenuWindow resource leak: its brushes / text formats / stroke style are raw-pointer members (they do not live on the rootElement_ chain), so every menu open leaked a full set of D2D/DWrite resources; added ~MenuWindow() to Release() them all.
  • UIElement::SetParent: detaching to nullptr never marked the old parent's childrenDirty_, so its child view cache stayed stale; now both the old and new parent are marked.
  • UIElement::AttachWindowRecursive (base): now recurses GetChildren() by default, fixing stale subtree windowId_ when an ordinary control is moved (previously only containers that overrode it recursed).
  • WndProc self-destruct guard: now also checks GWLP_USERDATA == self and clears GWLP_USERDATA on WM_NCDESTROY, covering HWND-handle reuse.
  • TableView / TreeView child cache: the column check changed from a width sum to an order-sensitive hash, fixing a stale layout after swapping two column widths (cell text stayed at the old positions).

New controls / ScrollBar extraction (v1.11.0)

  • Icon system FontIcon + Icon (new header ZufyUIIcons.h): the enum value IS the font codepoint; Win11 Segoe Fluent Icons / Win10 Segoe MDL2 Assets with runtime fallback; glyph layouts go through the global FontManager cache.
  • TabView: a compact top tab strip (centered text + selected light-blue background #D6E8FB + underline indicator + hover + rounded border); optional close x (darkens on hover); content hosted by an internal PageHost so switching reuses the transition animation; on overflow, ◀/▶ buttons (shown per scrollable direction) plus a bottom horizontal scrollbar; the wheel scrolls tabs only over the strip; closing a tab slides the rest into place.
  • RadioButton + RadioGroup: circular radios; group mutual exclusion (an explicit group, not inferred from the parent), vertical/horizontal, group keyboard navigation (skips disabled items), selected item gets a light-blue row background + accent left bar; SelectionChanging (veto) and SelectionChanged enable custom exclusion/linkage.
  • ScrollBar extracted into a standalone reusable control (from ScrollViewer): self-contained hover-expand + idle-shrink (default 2s -> thin line) and a callback-based value (drag immediate / track-click smooth); shared by ScrollViewer and TabView.

New controls / UX (v1.12.0)

  • ProgressRing: determinate (arc + eased value changes) / indeterminate (head advances exactly 2 turns per cycle + sweep "breath" -> no jump, tail never reverses).
  • NumberBox (numeric input / spinner): internal TextBox + character filter + IME disabled; overlaid inside the box on the right: up/down steps and a clear × (shown when the value differs from the default; click restores it); empty text -> error (the control's own behavior); ValueChanged (commit) / TextChanged (live validation); out-of-range input clamped to [min,max].
  • SplitView (two panes): draggable splitter (rounded + hover highlight); dragging re-marks only the two children (not the whole control); each pane is clipped to pane rect ± bleed; multi-pane via nesting.
  • TextBox: new bottom blue indicator (replaces the bottom border, blends with corners), error state (SetError, whole box turns red, border width unchanged), IME toggle (SetImeEnabled); read-only shows no caret (still selectable).
  • ScrollBar: extracted into a standalone reusable control; 2s idle shrink, hover restore + hover animation.
  • Fix: containers (LayoutHost / SplitView / NumberBox) previously did not recurse the animation tick down to their children -> child hover/page animations did not run; fixed.

Frame-pacing fix · buttery animations (v1.12.1)

  • Symptom: frame rate measures 60 but looks like 30-40 ("stuttery").
  • Root cause: uneven frame intervals (not a low frame rate). WM_TIMER queues InvalidateRect -> WM_PAINT gets jumped by mouse/keyboard messages, so the frame start drifts and Present1(1) quantizes it into whole-vblank misses; the timer (~15.6ms) and vblank (16.67ms) are also inherently misaligned -> periodic micro-hitches.
  • Fix (two small changes):
    1. In WM_TIMER, use RedrawWindow(..., RDW_INVALIDATE | RDW_UPDATENOW) to synchronously trigger WM_PAINT (bypass the message queue);
    2. In OnPaint, schedule the next frame right after Present1(1) returns (InvalidateRect) -> the cadence is driven by vblank instead of the timer.
  • Result: subjectively far smoother, close to native WinUI.

Right-click menu / CPU fixes (v1.12.2)

  • Fixed "right-click menu never appears while the main window has a sustained animation": the root cause is that WM_PAINT has higher retrieval priority than WM_TIMER — the main window's present loop posts a WM_PAINT every frame, starving both the menu window's fade-in timer and its own WM_PAINT, so the menu stays at opacity 0 forever (looks like "it never opens"). Now the menu is set opaque immediately and painted synchronously once via RedrawWindow(RDW_UPDATENOW), no longer depending on a starved timer. (Side effect: menus no longer fade in; they appear instantly, for reliable display under continuous animation.)
  • Lower CPU: removed the "hovering any element that has a tooltip keeps HasRenderWork() true" condition from HasRenderWork() — it made the timer repaint the whole window every 16ms. The tooltip's 500ms delay and fade-in are already advanced by UpdateTooltip() inside the timer tick; they don't need repainting to progress.
  • Lower GPU: no longer stuffs the whole "active animation set" (one spinner drags a dozen+ ancestor containers) into pendingRepaint_ every frame — measured to cause a full-window recomposite each frame (~10% GPU).
  • Frame pacing: WM_TIMER is back to InvalidateRect (removed the previous RDW_UPDATENOW synchronous draw) to avoid double-drawing every frame on top of the present-driven loop and to stop clogging the message pump; the present-driven next-frame gate changed from HasRenderWork() to "an animation is actually running", avoiding a self-sustaining loop that starves WM_TIMER (which would stop tooltips from showing).
  • Menus: MenuWindow's GetFactory AddRef was not paired with a Release (one factory reference leaked per menu); the same submenu is no longer re-opened when it is already expanded.
  • Controls: TabView::LayoutStrip now has a zero-size guard (avoids bogus arrangement at zero width/height); ProgressRing now uses UseCache()=false (it changes every frame; the cache would just be rebuilt needlessly); NumberBox::ResetToDefault() now clears the error state and fires TextChanged after restoring the default.
  • Version 1.12.1 -> 1.12.2.

Framework Timer / Label icons / Label-based tabs (v1.13.0)

  • Framework Timer (signal-based): Window::CreateTimer(ms) -> std::shared_ptr<Timer>; Timer::Tick is a ZSignal<>. Still WM_TIMER underneath, but the id uses a reserved framework range (0x7F00+) so it never collides with the library's internal id or app-defined ids; the timer auto-detaches when the window is destroyed and auto-Stops/unregisters when the Timer is destroyed.
  • Label built-in glyph icon: SetIcon(Icon[,size]) / SetIconColor / GetIcon (reusing the existing image-icon slot; size<=0 follows the font size; color defaults to the text color; icon-only when there is no text); the "icon + text (+children)" block is aligned as a unit (so on a button the icon hugs the centered text).
  • Icon system moved to the core: Icon / IconGlyph / IconFontFamily moved from ZufyUIIcons.h to ZufyUIWidgets.h, usable by any control; FontIcon / MakeFontIcon remain in ZufyUIIcons.h.
  • Button forwards the icon: SetIcon / GetIcon / SetIconColor (to its internal Label).
  • TabView tab titles are now Labels: AddTab(shared_ptr<Label>, ...) / SetTabLabel / GetTabLabel (the wstring overload stays as a convenience) -> tabs support icons naturally.
  • ScrollBar::ShrunkWidthRatio (default 0.30): hosts can reserve exactly the shrunk thickness; TabView's "tab strip <-> content" gap is now that thin-line thickness.
  • Frame-loop improvements (for "timers/popups starved while animating"): before the present-driven self-continuation, dispatch due WM_TIMERs (fixes inaccurate periodic polling), and add a yield gate HasSiblingWindowNeedingPaint() (EnumThreadWindows + GetUpdateRect, a precise test) — if another window of this thread is waiting to paint, the current round does not schedule its own frame, so their paint is not postponed indefinitely.
  • Menu open fade-in restored (ShowAtPoint: synchronously paint one frame first, then SetContentOpacity(0) + fade in; WM_TIMER is no longer starved).
  • Version 1.12.2 -> 1.13.0.

2026-09-26 — Tray / taskbar / menu enhancements + app identity self-registration

Menus

  • Rebuilt the right-click menu as a layered window with self-drawn soft shadow, rounded corners, and fade-in; fixed "menu won't open a second time" (root cause: the checkmark's ID2D1StrokeStyle was a static reused across factories → EndDraw returned D2DERR_WRONG_FACTORY; now created/released per instance).
  • Menu item enhancements: id / check / radio / default item (bold + Enter) / danger (red) / shortcut hint / disabled; per-item bgColor / textColor / font; Menu::font / SetDefaultFont.
  • Dynamic menu factory UIElement::SetContextMenuFactory (built on each right-click) + SetContextMenuEnabled.
  • Standalone popup Menu::ShowAt / ShowAtCursor (bound to no window; for tray menus); open menus are mutually exclusive.
  • Hover highlight is now a translucent overlay (still visible over a custom background).

Tray / taskbar / icons

  • TrayIcon (Shell_NotifyIcon v4): hover / click / right-click / double-click, badge (self-drawn composite), balloon (ShowBalloon, BalloonIcon = None/Info/Warning/Error/Custom, realtime / silent); auto re-added after explorer restarts.
  • Taskbar: progress (SetTaskbarProgress), overlay badge (SetTaskbarOverlayIcon), thumbnail toolbar (SetThumbButtons, the Image overload auto-builds an HIMAGELIST), jump lists (SetJumpList, tasks + categories + recent).
  • Window::SetAppIcon (unifies native big/small + class icons + custom title bar), ShowActivate (four modes), Flash (FLASHW_ALL); TitleBar icon badge / progress.
  • Image::ToHICON / CopyPixelsBgra.

Data views

  • ListView::ItemRightClicked(row) + GetContextRow(); TableView::CellRightClicked(row,col) + GetContextRow()/GetContextColumn() for list/table right-click menus.

App identity self-registration (new)

  • Declare AppInfo{ displayName, aumid, icon } + RegisterApp(...) (free function / Application::RegisterApp forwarding): sets the process AUMID so toast / jump list / taskbar grouping share one identity.
  • Requires the explicit authorization macro ZUFYUI_ALLOW_APP_REGISTRATION; when authorized it writes HKCU\...\AppUserModelId\<AUMID> (DisplayName + IconUri) and caches the icon at %LOCALAPPDATA%\ZufyUI\AppReg\<AUMID>\app.ico, cleaning both up on process exit; without the macro it only sets the AUMID (zero side effects).

Build

  • Added a precompiled header pch.h / pch.cpp (demo compile ~1.1s); Release drops debug info; Debug adds /bigobj.

Note (historical): menu popups early on used the "layered window + software render target" path and each menu created its own D2D factory → ~+90MB per open; fixed since v1.8.0 (MenuWindowBase : Window + DComp + process-shared device). Kept only as history.

2026-09-20 — Performance work + backdrop API consolidation (v1.9.6)

  • Performance: page-switch peak memory 300–400MB → capped at ~30MB; layout rework (DesiredSize cache + two-level dirty flags; no more "clear all caches on any layout invalidation"; page switches no longer trigger a full relayout); no per-frame full-tree hit-testing while dragging/resizing; global cross-widget text-layout cache + binary-search ellipsis for Label; no per-element GetDpi().
  • Backdrop API consolidated to "a 3-way layer + an overlay colour": Backdrop is only None / Acrylic / Mica; BackdropMode removed; ReloadAcrylic/ReloadMica removed; new SetBackgroundParams(layer, BackgroundParams/AcrylicPreset) plus AcrylicParams/MicaParams. Acrylic/Mica are rendered by ZufyUI itself, identical on Win10 and Win11.
  • Data views: ListView gains BeginUpdate/EndUpdate for batched add/remove.
  • Fixes: sort now emits SelectionChanged; ComboBox filtering keeps the selection; TextBox undo stack; CaptionButton press behaviour; scrollbar divide-by-zero guards; image cache device epoch.

2026-09-19 — Post-1.8.0 fixes and polish (v1.8.1)

Backdrop

  • The DComp acrylic background layer is now rebuilt at runtime (new UpdateDCompBackdrop()): SetBackdrop / SetBackdropMode work even after the window is created; switching Acrylic → Mica/other properly clears the old layer (no more see-through/black); it is also re-attached after device-loss rebuilds.

Window

  • Added Window::SetTitle(const std::wstring&) and Window::SetIcon(HICON bigIcon, HICON smallIcon) (native title bar; use TitleBar::SetTitle with a custom title bar).
  • SetCustomTitleBar now applies the current SetTitleBarVisible state, removing the "hide then install" inconsistency.

Signals (connections)

  • Connection is now a Qt QMetaObject::Connection-style passive handle: copyable, and destroying it no longer disconnects. UIElement::Connect(...) now returns a Connection; ignoring the result is safe, and to disconnect a single connection use auto c = elem->Connect(sig, slot); … c.disconnect();. Auto-disconnect is still handled by the element's ConnectionGroup (ImageManager's DeviceReset subscription also goes through a group). Removed the redundant autoConnections_.

Data views / controls

  • TableView cell keys changed from (long long)row*10000+col to (uint64)row<<32 | col, fixing key collisions when a column index ≥ 10000 (cellSel_ / cellTextColors_ / cellTips_).
  • ListView::MoveItem now fires SelectionChanged (and EnsureVisible).
  • ComboBox item widths are cached (recomputed only when data changes) and SetToolTip was moved out of Measure (no per-frame measuring / side effects).
  • ScrollViewer clips content to the viewport (new UIElement::SetClipRect), so it no longer draws under the scrollbars; the scrollbars themselves are unaffected.

Misc

  • PageHost gained transition easing TransitionEasing { Linear, EaseInOut, EaseOut }, default EaseInOut (smooth); switch via SetTransitionEasing.
  • Process DPI awareness is set once; removed the dead D2DERR_RECREATE_TARGET branch.
  • Memory leak fixed: AppCore::dqController_ is held/released via ComPtr.
  • Demo: removed the standalone "custom title bar window" (the main window is already custom).

2026-09-19 — Rendering migrated to DirectComposition + backdrop/signal API overhaul (v1.8.0)

Rendering: migrated to Direct2D 1.1 + DXGI flip SwapChain + DirectComposition

  • Window no longer uses ID2D1HwndRenderTarget; it now uses an ID2D1DeviceContext + IDXGISwapChain1 (CreateSwapChainForComposition) + a DComp visual tree, with WS_EX_NOREDIRECTIONBITMAP, so content is submitted via DComp and per-pixel transparency is supported.
  • AppCore shares a process-wide ID3D11Device → IDXGIDevice → ID2D1Device and WinRT ICompositor across windows.
  • Device loss / DPI change / resize go through a unified discard-and-recreate path (DiscardDeviceResources / ResizeSwapChain); new DeviceLost / RenderingError signals.

Acrylic: switched to the DComp HostBackdropBrush + Gaussian blur

  • Acrylic is now drawn by a DComp background layer (ICompositor3::CreateHostBackdropBrush, falling back to ICompositor2::CreateBackdropBrush, wrapped in a Gaussian blur effect) that samples the host backdrop, together with DWMWA_USE_HOSTBACKDROPBRUSH + AccentState(HOSTBACKDROP); it no longer relies on DWMWA_SYSTEMBACKDROP_TYPE, which breaks as the window frame changes.
  • Includes a hand-written IGraphicsEffect / IGraphicsEffectD2D1Interop wrapper (no Win2D); new dependency on d2d1effects_2.h and dxguid.lib.

Backdrop API overhaul ("what" vs "which API")

  • New Backdrop { None, Normal, Blur, Acrylic, Mica, MicaAlt }: what effect you want.
  • BackdropMode { Auto, System, Accent }: which API implements it.
  • SetBackdrop(Backdrop, tint = 0) / GetBackdrop(), SetBackdropMode / GetBackdropMode().
  • Removed the old WindowBackdrop / SystemBackdropMaterial (confusing names/semantics).

Callbacks → signals

  • UIElement events changed from raw std::function members to signals: MouseEnter / MouseLeave / MouseMove / MouseDown / MouseUp / KeyDown / KeyUp / Char / Focused / Blurred.
  • MenuItem::Clicked, CaptionButton::Clicked (default behaviour wired by DefaultTitleBar; custom title bars can connect/intercept themselves).
  • New Window::Closing (ZSignal<bool*>, set *cancel=true to cancel, e.g. "confirm before close"), Window::BackdropUnsupported / Window::DeviceLost / Window::RenderingError.
  • Global UIZSignals::DeviceReset: fired when render device resources are discarded/recreated, so subscribers can clear device-keyed caches (ImageManager clears image bitmap caches, fixing dangling render-target keys and bitmap leaks).
  • Removed SetBackdropUnsupportedHandler / SetDeviceLostHandler / SetRenderingErrorHandler.

Window

  • Window::Create no longer shows the window automatically; the app decides when to Show().
  • Custom title bar: added per-button enable/visible control: TitleBar::GetButton / SetButtonEnabled / IsButtonEnabled / SetButtonVisible / IsButtonVisible; DefaultTitleBar convenience SetMinimizeEnabled / SetMaximizeEnabled / SetCloseEnabled and ...Visible.
  • DWMWA_BORDER_COLOR now defaults to the system default (no hard-coded grey).

Fixes and cleanup

  • ComboBox popup hover/click hit-testing now uses the same width as drawing (ListWidth()), fixing the unreachable overhang on the right.
  • TableView::SortByColumn remaps checkedRows_ after sorting.
  • Double-click detection now uses the system GetDoubleClickTime() (three places).
  • ScrollViewer::Arrange uses SetVisibleNoInvalidate() to avoid a layout loop; DrawTextWithEllipsis truncation changed from O(n²) to binary search.
  • MenuWindow positioning now uses MonitorFromPoint + GetMonitorInfo.
  • Removed several fallback/temporary bits (debug-only PageHost special case, unused animationIdleFrames_, etc.).

Demo (ZufyUI.cpp)

  • The main window now uses a custom title bar.
  • The separate small tool window was removed; the multi-window / owned / modal demos moved into a new "Multi-window" page of the main window.
  • Version bumped to 1.8.0 (new ZufyUI_VERSION_STRING etc. macros, referenced by the demo title).

2026-09-16 — Custom title bar (ZufyUIWindowTool) and backdrop modes

New: custom title bar (new file ZufyUIWindowTool.h)

  • TitleBar / CaptionButton / DefaultTitleBar: window-level controls installed as a non-layout overlay via Window::SetCustomTitleBar; pass nullptr to restore the native title bar.
  • The three caption buttons are drawn with the system icon font (Segoe Fluent Icons / Segoe MDL2 Assets, glyphs E921/E922/E923/E8BB), with hover/press gradients and red close hover #C42B1C; buttons report HTMINBUTTON/HTMAXBUTTON/HTCLOSE from WM_NCHITTEST, enabling the system Snap Layouts; clicks are handled in WM_NCLBUTTONUP; the title bar area is the drag region (drag / Aero Snap / double-click maximize handled by the system).
  • The title bar and buttons are not Tab-focusable; default DrawAfterLayout, UseCache.
  • Helpers: SetTitleBarVisible, SetButtonsEnabled, SetButtonWidth/Height, SetRightMargin, CaptionButton::SetAnimationSpeed, etc.

New: layout participation / drag mechanism (UIElement)

  • LayoutParticipation { Normal, DrawBeforeLayout, DrawAfterLayout }: non-participating elements are drawn by the window before/after the normal layout tree; layouts and the ComposeImpl child recursion skip them.
  • Drag regions: SetDraggable / SetDragRegion / CollectDragRegions; the window collects them each frame and feeds WM_NCHITTEST (returns HTCAPTION).

New: three backdrop modes

  • BackdropMode { Auto, Acrylic, SystemBackdrop } + SystemBackdropMaterial { Auto, Mica, MicaAlt, Acrylic } + SetBackdropUnsupportedHandler.
  • SystemBackdrop uses Win11 DWMWA_SYSTEMBACKDROP_TYPE; if unsupported the handler is called and it falls back to AccentState.

Window / frame fixes

  • Snapped windows keep the DWM border and shadow: WM_NCCALCSIZE insets only the edges snapped to the work area (using the actual DWMWA_VISIBLE_FRAME_BORDER_THICKNESS), and maximizing does not inset; SWP_FRAMECHANGED is sent when the maximize/snap state changes.
  • From maximized, dragging down from the top edge restores the window; the close button aligns with the native position.

Demo: ZufyUI.cpp gained a "custom title bar window".

Known limitations (important)

  • ZufyUI currently renders through ID2D1HwndRenderTarget (an opaque redirection surface) and cannot display DWM system materials: BackdropMode::Auto uses AccentState on both Win10 and Win11, and SystemBackdrop is not visible until the render target is migrated to DirectComposition (it looks gray/black).
  • AccentState acrylic is an undocumented API and makes DWM skip window transition animations (minimize/maximize) on both Win10 and Win11. Getting "acrylic + native animations + Mica" together requires migrating rendering to DirectComposition (SwapChain / CompositionSurface), which is planned.

2026-09-15 — Image system, window mechanisms, and root-cause fixes

Images (new ZufyUIImages.h)

  • New Image: WIC decoding + Direct2D (GPU) drawing/transforms. Loading: FromFile / FromMemory / FromBase64 / FromResource(HMODULE,name,type) / FromResource(id,type) / FromHBITMAP / FromHICON; transforms: Scaled / ScaledToWidth / ScaledToHeight / Rotated / Mirrored / Cropped (lightweight descriptors applied by the GPU at draw time); drawing: Draw (opacity / interpolation), Bake; encoding: Save / Encode (CreateStreamOnHGlobal memory stream, no temp files).
  • ImageManager: shared IWICImagingFactory and device-cache registry; ImageDeviceCache: one ID2D1Bitmap per render target, rebuilt on device loss. The same image is uploaded to the GPU once per window.
  • Root-cause fix: IWICStream::InitializeFromMemory does not copy the buffer and decoding/conversion are lazy; pixels are now copied into an independent WIC bitmap immediately at decode time via WICBitmapCacheOnLoad, so FromMemory/FromBase64/RT_BITMAP no longer read freed memory while drawing (previously the image never appeared).
  • Root-cause fix: the transform matrix composition in DrawWithTransform was reversed, pushing rotated/mirrored images out of the target rect (they appeared missing); fixed by using the Rotation/Scale overloads that take a center.
  • Label now supports an icon and nested children: SetImage/GetImage, SetIconSize/GetIconSize, SetIconSpacing/GetIconSpacing, AddChild/ClearChildren/GetChildCount (icon + text + children laid out inline).

Windows

  • RunModal now uses the official mechanism: EnableWindow(owner, FALSE) + activating the modal window + an IsDialogMessage nested loop; the global low-level mouse hook was removed (it used to swallow clicks for other processes, breaking the whole desktop's input while modal).
  • Owned child windows now establish the owner relationship at creation (via the CreateWindowEx parent parameter), so they have no separate taskbar button; when the owner is minimized their owned children are hidden unconditionally and restored on restore/activate (no longer relying on the shell's minimize grouping, which fails when the owner is in the background).
  • New convenience APIs: Flash(times=5, captionOnly=true) / StopFlash() (FlashWindowEx), GetOwnedWindows(), GetStyle()/GetExStyle(), SetWindowStyleFlag/SetWindowExStyleFlag (e.g. WS_EX_TOOLWINDOW), Show()/ShowNoActivate()/Hide()/Raise().
  • New OwnedMinimizePolicy { None, Hide, DisableMinimize } + SetOwnedMinimizePolicy for how an owned child handles being minimized on its own.
  • Fix: on destroy a window clears every reference other windows hold to it (owner_ / hidden lists), so address reuse can never affect unrelated windows.
  • Fix: SIZE_RESTORED also fires while dragging to resize, which used to unconditionally restore hidden owned children (resizing made them pop back); now they are restored only on a real "minimize -> restore".

Controls / rendering

  • Root-cause fix: when an element cache bitmap is composited onto the main render target, the destination pixel size must exactly match the bitmap's pixel size; otherwise any interpolation resamples the whole cache and text looks blurry. Now the destination size is derived from the bitmap's actual pixel size.
  • ComboBox: the collapsed box sizes to the average item text width (overflow is ellipsized with an automatic ToolTip of the full text); the drop-down list sizes to the widest item so every option is fully visible; fixed the scrollbar being drawn in the middle when the list is wider than the box.

Docs

  • API docs gained an Images chapter (zh/en), plus new Window, Label, and ComboBox APIs and notes.

2026-09-13 — Major update: interaction states, shadows / tooltips, controls and data views

Core

  • UIElement gained: enabled/disabled (SetEnabled/IsEnabled/IsEffectivelyEnabled — disabled state inherits from the parent chain, blocks mouse/keyboard input, and controls grey themselves), generic tooltips (SetToolTip/GetToolTip), shadows (SetShadow/SetShadowColor/SetShadowBlur/SetShadowOffset/SetShadowCornerRadius/GetShadowExtent), and a context-menu hook OnContextMenu.
  • Window: element shadows are composited into the offscreen cache; a shared tooltip overlay (anchored at a fixed offset above the mouse position when shown, fades in after a 0.5s hover, white background with black text and a soft shadow, dismissed as soon as the mouse moves); Tab focus traversal (the focus ring is shown only for Tab navigation, not for mouse clicks).
  • Shadows rewritten as layered Gaussian CDF (DrawSoftShadow): per-layer alpha is derived from the Gaussian distribution so the composite approximates targetA·(1-Φ(d/σ)); the alpha of SetShadowColor now means the visible edge opacity (the interior is roughly 2×).
  • Frame-time clamping: deltaTime in OnPaint is capped at 0.033s, fixing animations that jumped straight to their end after an idle period or a restore from minimize.
  • PageHost: fixed a bug where, during a page transition, the same page was updated twice per frame, doubling the speed of animations nested inside it.
  • Timer precision: timeBeginPeriod(1) on window creation and timeEndPeriod(1) on destruction reduce animation jitter.
  • Debug output is now controlled by the ZufyUI_DEBUG macro (off by default; define it to enable); Release hot paths no longer build debug strings.
  • Performance / memory: GetChildren() now returns const& (reused buffer, no per-frame allocation); ZSignal::Fire uses a thread-local snapshot; Compose culls subtrees entirely outside the clip; the active-animation set reuses a buffer; DrawSoftShadow uses fixed-size arrays to avoid per-frame heap allocation.

Basic controls

  • Button: disabled state, Enter/Space activation, checkable mode (SetCheckable/SetChecked/IsChecked/Toggled), text alignment / padding, auto-repeat.
  • CheckBox: hover halo animation, text label and color, hover box color, keyboard, disabled.
  • ToggleSwitch: disabled, text label, keyboard, SetSize, indeterminate state, custom colors.
  • Label: padding, line spacing, max lines (with ellipsis), GetDesiredSize, disabled color.
  • ProgressBar: ValueChanged, range, percentage text with text color, disabled.
  • Slider: SliderReleased, stepping / snapping (SetStep/SetSnapToStep), arrow keys / Home / End, disabled.
  • ScrollViewer: scrollbar visibility policy (Auto/Always/Hidden), ScrollChanged, GetScrollOffset, per-instance colors, ContentMargin.
  • TextBox: read-only (SetReadOnly), input filter (SetInputFilter), ReturnPressed, public selection / undo / copy-paste / select-all, placeholder color, password reveal (SetRevealPassword); fixed Shift and mouse-drag selection not accumulating (independent anchor).
  • ComboBox: data add/remove/query, placeholder, per-item disabled, max visible items, open/close signals (DropDownOpened/DropDownClosed), editable + input filtering (SetEditable/SetFilterEnabled/SetEditText, with a blinking caret and click positioning).

Data views

  • ListView: new None selection mode; type-ahead; sort comparator + indicator; per-item disabled / text color / tooltip (bound to the item itself, so they survive sorting); keyboard navigation skips disabled items.
  • TableView: per-column sorting + indicator (row-level metadata is remapped when sorting or inserting/removing rows/columns); cell text color / tooltip; per-row disabled; column hiding; column alignment; per-row height; keyboard navigation skips disabled rows.
  • TreeView: filter / search, GetNodePath, default expand depth; per-node tooltip wired to the shared tooltip in the base class.

Docs

  • Added this changelog; the API docs were rewritten from a "list of signatures" into a more detailed "implementation notes + pitfalls" style; added a warning about signal/object lifetime reference cycles.

2026-09-13 (cont.) — Multi-window support (Application)

  • New ZufyUI::Application: app.CreateWindow(...) to create windows and app.Run() for a single shared message loop, Qt style; windows are truly independent.
  • Repaint/layout are routed per owning window (UIElement::GetWindow()); the DPI scale is now thread-local (set per window before drawing); Window gained instance signals Activated / Deactivated / Closed, and UIZSignals::WindowDeactivated / GlobalMouseDown now carry a Window*.
  • Closing one window no longer quits the app; it quits when the last window closes. The ID2D1Factory and timeBeginPeriod are shared by the app core.
  • All window-related global signals now carry a Window* (DrawOverlay / GlobalMouseDown / WindowDeactivated, plus capture and repaint fallbacks); subscribers filter with GetWindow(). This fixes the cross-talk where window A's popup was drawn onto window B or clicking B wrongly collapsed A. Added Window::SetPosition/SetSize/IsValid.
  • Fixed ComboBoxes holding the thread-wide system mouse capture after expanding (which made other windows unusable): Win32 capture is now held only while the mouse button is down and released on mouse-up (element-level logical capture is unaffected); also handled WM_CAPTURECHANGED.
  • Added modal and owned windows: Window::SetOwner / GetOwner, Window::RunModal(owner), Application::CreateWindow(..., owner); while modal, clicking the disabled owner flashes the modal window.
  • Robustness: elements store the owning window as an id (instead of a raw pointer); after the window is destroyed GetWindow() returns nullptr, removing crashes from dangling window pointers.
  • Fixed PageHost calling ReleaseDeviceResources() on non-current pages every frame after a transition finished (now released once, on the completing frame); non-current pages are made invisible, so expanded controls (ComboBox) auto-collapse.
  • Fixed UIElement::Connect returning a moved-from empty Connection (now returns nothing); fixed TreeView::RemoveChildren not clearing checkAnim_ (dangling node keys).
  • Added AGENTS.md codifying the principle: for any bug, find and fix the root cause first — never mask it with a new mechanism.
  • Backward compatible: Window win; win.Create(...); win.Run(); still works. #undef CreateWindow avoids the Win32 macro clash.
View sourceCHANGELOG.en.md