> Only the changes that affect your code are listed.
- **v1.15.0**: data-view virtualization (`SetItemCount` etc.) + hide/filter/visible-order sort (two coordinate systems); cross-thread/locking hardening; `ComboBox` source-index API; `TreeView::BeginUpdate/SetNodeText`.
- **v1.17.0**: **UIA accessibility** (on by default); **external debug/automation channel** (`SetDebugEnabled`, off by default, commands 1~22); **layout stretch weights** (`ColumnBox`/`RowBox`/`GridLayout` distribute leftover by weight); **automatic ellipsis tooltips** (Label/Button); `CaptionButton::Kind::Pin`; `TreeView` node `bgColor` / `Get/SetScrollOffsetY` / `ScrollToNode`; `Window::DefaultBackdropColor` pure white.
- **v1.18.0**:
- New `ZufyUICharts.h`: `ChartBase` / `BarChart` / `LineChart` / `PieChart`; `BarChart` horizontal orientation; `PieChart` wheel zoom.
- New `TextEdit` multi-line editor/viewer; `TextRun`; base `AcceptsTab()`.
- `UIElement::ReleaseDeviceResourcesRecursive()`; `PageHost` delayed hidden-page cache release (~1.2 s); `ScrollViewer::UseCache()=false`; `SetUseCache(false)` frees immediately.
- Library fixes: `Snap` DPI scale also set on the UI thread; `ZSignal::Fire` RAII exception safety; `TextBox` shift+click; `Slider` zero-width NaN guard; `ListView` pooled-label re-measure on width change (`poolW_`).
- **v1.19.0**:
- New **drag & drop** (`ZufyUIDragDrop.h`): `Window::BeginDrag` + `DragDataBuilder`; element `SetDropTargetEnabled` / `OnDragEnter/Over/Leave/Drop` + signals; `Label`/`Button`/`TextBox`/`TextEdit`/`ComboBox` accept and start drags; drag files out to Explorer.
- New `Expander` (collapsible card: smoothstep easing + rotating arrow + header hover highlight), `SettingsList` (settings rows); image display uses `Label::SetImage` + `SetImageFit` (scale to fully visible).
- `ComboBox` dropdown arrow is now a chevron that rotates with expansion.
- Text drag now has **move** semantics: the source deletes the original selection first, then inserts at the drop point (private format dedups same-control drags).
- **v1.19.1**:
- `TextEdit` undo/redo switched to the **standard scheme** (stack top = current state): both undo and redo **restore the selection and cursor** of that point; Backspace/Delete/typing/paste are one step each; drop insert/move are undoable and redoable.
- `ScrollViewer`: content is measured at the **viewport width** (fixes "clipped cards" and wrong scroll range from an infinite desired width for FillWidth/wrapping content); content is measured **twice** (re-measured at the narrower width once a vertical bar appears); the content element's own **`margin` is honored**; the clip gets a **1px bleed** so edge borders are not cut in half.
- The drop caret now shows even when the target is **unfocused**; during a drag the **source selection is preserved** and a preview caret shows at the drop point; dropping inside the original selection is a no-op.
- `Expander`: header hover highlight (no longer covering the card border), arrow rotates with the collapse easing, `SetIcon` leading icon.
- Whole-window drag & drop: `Window::SetDropTargetEnabled` + window-level `DragEnter/DragOver/DragLeave/Drop`.
- Image display merged into `Label` (new `SetImageFit`); the standalone `ImageView` is removed.
- **v1.19.2**:
- New top **menu bar** `MenuBar` (VS-style: click opens the `Menu`; hovering only highlights, **no auto-expand**; the open entry stays **pressed** until the menu closes; overlaid on the custom title bar by default, empty areas pass through so the title bar stays draggable).
- New bottom **status bar** `StatusBar` (left/right panels: optional icon + text).
- `Window`: `SetMenuBar` / `SetStatusBar` / `SetMenuBarInTitleBar` / `SetShowTitleText` (title text and an on-title-bar menu are **mutually exclusive**).
- `Menu` gains an `onClosed` callback; `MenuWindow::OnPopupClosed`.
- **v1.19.3**:
- New **theme system** (`ThemeRole` / `Theme` / `ThemeManager`; `Light/Dark/HighContrast`; window-level `SetTheme`; `UIZSignals::ThemeChanged/ThemeReapply`) — one palette by role; re-applied to the visible subtree on page/tab switch.
- **Follow system**: reads the registry light/dark + system accent, handles `WM_SETTINGCHANGE` / `WM_THEMECHANGED` / `WM_DWMCOLORIZATIONCOLORCHANGED` / `WM_SYSCOLORCHANGE`; `ThemeManager::SetFollowSystem(bool)`.
- **Explicit instance color wins**: once a control's `Set*Color` is called it is flagged "user-colored" and the theme no longer overrides it; ListView items / TableView cells+rich cells / TreeView cells / headers / alternating rows / Tab selected+hover / radio / NumberBox hover / CheckBox hover all themed.
- `Backdrop` token (window base white/black); window periphery (caption buttons) follows the **system** theme; `ThemeManager::Map` color remap.
- Fixes: `ThemeReapply` connection leak (UAF); `SyncThemeBackdrop` swallowing user tint; ListView/TableView/TreeView theme overriding per-item colors.
- **v1.19.4**:
- New **DSL** (`ZufyUIDsl.h`): `Ref<T>` (`with/on/add` + layout shortcuts), `Make<T>`, `Col/Row/Grid` and per-control short factories — fluent construction / subtree assembly / signal wiring; demo gains a "DSL" page.
- Fix: `CheckBox` hard-coded `width_/height_` in its ctor → treated as a **fixed width** in `RowBox/ColumnBox` and the **label was clipped**.
- `ListView/TableView` `RefreshChildren` cache criteria collapsed into a **single signature** `ChildrenSig()` (criteria in one place, harder to forget); consistent with `TreeView`.
- `ChartBase::MeasureOverride`: falls back to `420×260` when `fill` but unconstrained/no size (no longer collapses to 0).
- `Window::SetMinSize` default content measure gets a **600 DIP** width floor; `pch.h` `ZufyUI_DEBUG` now `#ifdef _DEBUG`; `Theme::HighContrast` role colors distinguished (no longer all-yellow).
- **v1.19.5**:
- DSL enhancements: `dsl::App()` / `WindowApp` window builder (fluent config + `run()`); `Page()/Menu()/Settings()` short factories; **SFINAE-gated** per-control sugar (`text/checked/value/placeholder/padding/category/series/slice/item/menu`).
- The demo "DSL" page uses the sugar and chart composition (`Pie().slice(...)`, `Bar().category(...).series(...)`, `Progress().value(...)`).
- **v1.19.6**:
- Fix: `ListView` button mode checkbox **hit test was 4px off** (now aligned with the draw / child left edge).
- Fix: `Label::MeasureOverride` wrap branch **ignored inline children width** (wrapping Labels with `AddChild` squeezed/overflowed text).
- Docs: version is now a **single source** (`API.md`/`README.md` headers reference the `ZufyUI.h` macro; the generator `mdapi2html.py` injects `1.29.1`); cleaned stale items (`ImageView` default row, `Sort`→`SortItems`, `Menu::onClosed`, chart fill wording, README menu `+90MB` history entry); `mdapi2html.py` fixes `--theme auto` semantics and `c++`-style language names in the code-fence regex.
- **v1.19.7**:
- Fixes: `ChartBase` swapped horizontal/vertical scrollbar allowance (`viewW` uses the vertical bar, `viewH` the horizontal) → rightmost/bottom content unreachable; `NumberBox` wheel focus check (focus is on the inner `TextBox`); `lastActiveAnimElements_` dangling (erased from the anim sets on destruction, prevents random crashes); `Menu::ShowAt` throwing `bad_weak_ptr` when not shared-owned; `ChildrenSig` missing `EnsureView`; `TreeView::SetDefaultExpandDepth` not applied by `AddRoot`/`AddChild`.
- Fixes: `ColumnBox`/`RowBox` spacing counts only layout-participating children; `GridLayout` row/col count skips invisible; `Label` wrap ignored/duplicated spacing; `ListView`/`TableView` clear `childrenView_` before releasing labels and release pooled/rich/cell labels; `Window::defaultIMC_` via `ImmAssociateContext`; `DragData::GetFiles` buffer `len+1`; `TextEdit` fires `SelectionChanged` when clearing a selection; `MessageBox` default title localized.
- Added `TODO.md` (merges the former `FEATURE_PLAN.md`/`OPTIMIZATION_PLAN.md`; the single authoritative backlog).
- **v1.20.0**:
- **DSL**: `root()` now accepts **any `Layout` subclass** (previously only `Col` had a dedicated overload, so `Row`/`Grid` failed to compile because `Ref` → `shared_ptr<Layout>` needs **two user-defined conversions**); `titleBar/menuBar/statusBar` likewise take a `Ref<T>` directly.
- **DSL**: `add()` dispatches on the container's real API (`ColumnBox`/`RowBox`/`Label` → `AddChild`; `PageHost` → `AddPage`, skipping non-`Page` arguments; `GridLayout` goes through the new coordinate API). Added `dsl::Cell(row,col,child[,rowSpan,colSpan])` and `Ref::cell`, the `apply()` escape hatch, and `Wrap()`.
- **DSL**: more shortcuts — size limits (`minWidth/minHeight/maxWidth/maxHeight/minSize/maxSize`), stretch weights (`weight/hWeight/vWeight`), `cache/bleed/clipRect/noClip/cursor/dropTarget/contextMenuEnabled/accessible`, `spacing` (single-arg on `Col`/`Row`, two-arg on `GridLayout`), `padding(Thickness)`, `background/textColor`, `align` (GridLayout); per-control sugar gained `image/imageFit/items/rows/cols/header/cell/root(s)/separator/submenu`; new factories `RadioGroup()/ScrollBar()/Glyph()` (`Image` is a resource object, not a `UIElement`, so it has no factory — use the `Label::SetImage` sugar).
- **DSL**: `WindowApp::run()` **now calls `Show()`** — `Window::Create` does not show the window, so the previous implementation ran a **message loop with no window** (looked like a hang); added `hidden/minSize/position/frameRateLimit/theme/useAppTheme/dropTarget/icon/titleBarVisible/showTitleText/menuBarInTitleBar` and the window signal hook `on<&Window::Closed>` (`Window`'s signals are plain members, there is no `Connect`); `WindowApp` is now **movable** (it holds a `unique_ptr<Window>`, because `Window` itself is neither copyable nor movable).
- **Fix**: null guards in `ColumnBox`/`RowBox`/`GridLayout::AddChild` — the DSL's variadic forwarding can pass `nullptr`, which used to dereference a null pointer.
- **Fix**: `ZufyUIWindowTool.h` was **not self-contained** — it used `Label`/`Button`/`ColumnBox::AddChild` without including `ZufyUIWidgets.h`, relying on the caller to include it first (`pch.h` happened to do so); the include is now present and the header can be included on its own.
- **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` (adds a UTF-8 BOM only to C++ sources that contain non-ASCII and lack one, preventing the GBK misparse behind `C2143/C2259/C2888/C4819`), and `tests/zufyui_tests.cpp` + `tools/run_tests.ps1` (47 compile-time/runtime assertions, no window created, runnable from a shell or CI).
- **v1.21.0**:
- **Fix**: `Card` flashed a **blue hover border** — the theme applier set `SetHoverBorderColor(Accent)` on cards, a behaviour cards never had; removed (hover still changes the background).
- **Fix**: `ProgressBar` **inner fill radius no longer matched the outer frame after stretching** — the track, the clip geometry and the border still used the member `height_` (construction-time height) while only the fill used the arranged height; all three now use `arrangedRect_.height / 2`.
- **Fix**: `Button` captions were **ellipsized even with room to spare** — `MeasureOverride` returned a constant `width_` (set to `DefaultWidth = 120` in the constructor); it now grows to fit the text (`max(width_, textWidth + 2*padding)`), with `Button::AutoSizeToText` (static, default `true`) and `SetAutoSizeToText(false)`. **This is a layout behaviour change.**
- **New**: `ToggleSwitch` uses **duration-driven ease-in-out** (`DefaultAnimationDuration = 0.25s`, stops exactly on time); also fixes mouse-click/keyboard paths that bypassed `SetOn` and therefore never started the animation (the "instant snap").
- **New**: `ProgressBar` value **easing** (`DefaultValueAnimDuration = 0.22s`; fill and percentage text move together).
- **New**: `SplitView` **collapse**: dragging within the edge threshold first shows an "about to collapse" overlay (translucent accent + direction arrow, alpha fade, **content untouched**); the pane collapses on release (size eases to 0); afterwards a small button is drawn **on top of the content** at that edge (rounded light grey + arrow pointing in the expand direction + hover easing), and clicking it eases that side from 0 to its minimum limit. `SetCollapseEnabled(false)` disables the whole feature. Public API: `SetCollapseEnabled/IsCollapseEnabled/SetCollapseThreshold/CollapseFirst/CollapseSecond/Expand/IsFirstCollapsed/IsSecondCollapsed/GetCollapsedSide/IsCollapsing/GetCollapseProgress/SetExpandButtonColors/SetExpandButtonSize` plus the `CollapsedChanged(int)` signal.
- **New**: `detail::EaseOutCubic` / `detail::EaseInOutCubic` (duration-driven easing, one shared convention for in-library animations).
- **New**: `ThemeRole::Shadow` (**appended at the end of the enum** so existing values keep their numbers) with Light/Dark/HighContrast values; `UIElement::DefaultShadowColor`/`SetDefaultShadowColor`; `Window::SetBackdrop(Backdrop)` follows the theme (the `tint` overload means "locked") plus the `ApplyThemeToBackdropParams` hook.
- **Fix**: `PieChart` **Ctrl+wheel zoom did nothing** — `PieChart`'s own `zoom_` shadows `ChartBase::zoom_`, so delegating to the base only changed the base's copy; the pie now handles Ctrl itself via `SetZoom`. Semantics are explicit: **Ctrl+wheel = zoom / plain wheel = pan only**.
- **Fix**: chart wheel panning "did not move" — the wheel path was missing `SyncScrollPositions()` (it changed `scrollX_/scrollY_` but never recomputed `baseX_/baseY_`).
- **Fix**: documented that `ColumnBox` arranges a child **without an explicit width** at the available width (horizontal stretch ignores the weight) — so "make a card hug its content" means wrapping it in a `Row`; and that a `SettingsList` placed in a `Card`'s built-in `GridLayout` (auto columns pass `FLT_MAX`) degenerates to zero width — use `SetLayout(Col(...))` + `SetFillWidth(true)`.
- **Tooling**: `tests/zufyui_tests.cpp` 62 → **85** assertions (regressions for this batch: button auto-size on/off, label width follows text, progress/toggle easing convergence, SplitView collapse and expand-to-minimum).
- **v1.22.0** (**contains breaking API changes**):
- **Fix**: `MessageBox` (and any modal) **first click falling through to the window behind** — when a modal is opened from inside `Window::OnMouseUp`'s slot, that function's trailing `ReleaseCapture()` only runs after the modal loop ends, so the main window keeps `SetCapture` for the whole modal and Windows routes mouse input to the capture window; `Window::RunModal` now does `if (GetCapture()) ReleaseCapture();` before entering the loop.
- **Fix**: `ScrollViewer` **scroll chaining** — it no longer swallows the wheel at the top/bottom (returns `false` to bubble up the parent chain when that axis can't scroll further), so the outer page keeps scrolling.
- **Fix**: `SplitView` **expand had no easing + expand button jumped sides** — the old `Expand()` cleared the collapsed flags before starting the animation, but `PaneLengths` keyed off them; now a single `collapseSide_` drives both directions and is cleared only when the animation finishes.
- **Breaking · P0-1**: member functions with **default arguments split into non-defaulted overloads** (so `.with()` works): `TreeView::SetCheckable(bool)` + `SetCheckableShallow(bool)`; `SetNodeCheckable(node,bool)` + `SetNodeCheckableRecursive`; `SetNodeEnabled(node,bool)` + `SetNodeEnabledRecursive`; `SetNodeCheckState(node,state)` + `SetNodeCheckStateFull(...,updateChildren,updateParent)`; `ListView::AddItem(text)` and rich-item **`AddItemWidget(shared_ptr<Label>)`** (old name dropped); `RadioGroup::AddItem` / **`AddItemSelected`** / `AddButton` / **`AddButtonSelected`**; `Menu::AddCheckItem(text,checked)` / **`AddCheckItemCb`** / **`AddCheckItemRadio`**.
- **New · P0-2**: collision-free aliases `make_slider/make_card/make_page/make_menu/make_menu_bar/make_status_bar/make_radio_group/make_scroll_bar/make_expander`.
- **New · P1-2**: `Page::SetScrollableContent(content)` — one line wraps the whole page in a `ScrollViewer` + margin.
- **New · P1-4**: `ThemeManager::RegisterHook` / `RegisterSubtreeApplier` return a **RAII `HookHandle`** (auto-disconnect on destruction); the library's own fixed hooks use `RegisterHookPermanent` / `RegisterSubtreeApplierPermanent`.
- **Docs · P3**: added `docs/pitfalls.md`; `AGENTS.md` gained a "chaining / API conventions" section.
- **v1.22.1**:
- **Fix (layout)**: `RowBox` / `ColumnBox` `ArrangeOverride` did not clamp each child's `base` to its min/max before distributing leftover → a child with `SetMinWidth/Height` pushed its extra space onto a stretching sibling, **overflowing the row/column** (classic case: a `SetMinWidth` label + `SetFillWidth` slider → the slider grew too long and spilled outside its card). Now `base = clamp(base, min, max)` before computing leftover.
- **Behaviour**: `ColumnBox` / `RowBox` / `GridLayout` **no longer shrink content** — insufficient space now **overflows** and is left to an outer `ScrollViewer` (desktop UI does not compress content). `GridLayout` dropped its proportional row/column compression on overflow.
- **Fix (alignment)**: `GridLayout`'s `SetHorizontalAlignment/SetVerticalAlignment` never took effect because the test `colStretchWeights.empty()` was always false; now it checks "all zero", so `Center/End` work (only when no column/row stretch weight is set).
- **Fix (text/IME)**: `TextBox` / `TextEdit` now merge **UTF-16 surrogate pairs** (emoji / beyond-BMP) and insert them as one unit; `←/→`, `Backspace`, `Delete` move/delete across the whole pair. **On losing focus** the control clears its own composition state and the `Window` cancels the IME composition (`ResetImeState()`) — both control and program IME state reset. `TextBox::SetImeEnabled(false)` also clears composition.
- **Fix (accessibility)**: `GetAutomationIdOrAuto()` now uses a **per-window** counter (`Window::NextAccessibleAutoId()`), so multi-window/multi-root ids no longer collide; `ElementProviderFromPoint` descends **child-before-parent** to the deepest hit (e.g. a Button embedded in a Label).
- **Fix**: data view item/cell placement `bleedY` is read from each element's `GetBleed()` (no longer a fixed `3.0f`), so shadows/bleed aren't clipped; `indicatorY_` is initialised to `-1` so the selection indicator snaps on the first frame.
- **Fix (visual)**: the focus ring uses `ThemeRole::FocusRing` and `Theme::cornerRadius` (was a hard-coded blue + fixed 4); in `WM_NCHITTEST` the custom title-bar buttons take priority over the resize border (the maximize-button corner is no longer taken by `HTTOPRIGHT` → Win11 Snap Layouts can appear).
- **Engineering**: `pch.h` no longer includes the library headers (editing a lib header no longer rebuilds the whole PCH); added `UIElement::MarkUserColor()` centralising 40+ "user colour" markers; removed dead code `ListView::FindEnabledFrom`.
- **v1.23.0**:
- **New · `ZufyUIHwndView.h` (`HwndView`)**: native HWND content host. Because the main window is NRB+DComp (child HWNDs are not composited), it uses a **top-level owned popup** as the host; `SetContentHwnd` re-parents the external window as its `WS_CHILD` (cross-process allowed) and shows it. Moving the host moves the child natively; clipping = host client + `SetWindowRgn` (element rect ∩ window client ∩ ancestor `GetClipRect`, incl. the `ScrollViewer` viewport). Supports `SetObscured`, `SetOnBoundsChanged`, `SetFill*`.
- **New · `Window` external-visual attachment**: `CreateExternalVisual()` (WinRT `ContainerVisual` inserted atop the root visual, for WebView2 `put_RootVisualTarget`), `SetExternalVisualBounds` (DIP→physical px), `RemoveExternalVisual`; `AddOverlaySync/RemoveOverlaySync/SyncOverlays` (unified overlay sync).
- **Performance**: overlay sync is now a **single window-level point** (`WM_MOVE/WM_SIZE/WM_DPICHANGED` immediate + one shared 16ms fallback timer) instead of a per-instance timer; 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`**: the empty-text error clears once the text becomes a **valid number**; `ResetToDefault` force-clears the error after notifying the app; step/clear buttons fire **on press** (no re-check against the moving rect; fixes staying red after the × button).
- **Fix · data-view fill**: `ListView`/`TableView`/`TreeView` `MeasureOverride` honours `SetFillWidth/SetFillHeight` (like charts) instead of always returning the default 200/400.
- **Demo**: new "Native HWND" page (GDI color pattern + Card/Grid/Column/ScrollViewer layouts + an out-of-process `--outproc` producer window hosted by `HwndView`).
- **v1.23.1**:
- **Fix (layout / hit-testing)**: `PageHost::MeasureOverride` now **measures every page**. Previously `PageHost` only arranged pages while `Page::Arrange` re-measured solely on a size change, so page content made visible at runtime (e.g. an `Expander` card revealed after a combo-box selection) was never re-measured: the new element kept a zero `arrangedRect` (no border, `HitTest` failed) until the window was resized. Clean pages hit the `Measure` cache, so no duplicate work is added.
- **v1.23.2**:
- **Build**: added `/bigobj` to the **Debug|Win32** / **Debug|x64** configurations of `ZufyUI.vcxproj` / `ZufyUIDebugger.vcxproj` (Release already had it); the full Release/Debug matrix passes.
- **v1.23.3**:
- **Button**: the internal `Label` is a real child now (rich content via `GetLabel()->AddChild` / `SetContent`); added the drop 2x2 switches (`SetDropWriteBack` / `SetDropOpenOnClick`) and a single-select menu (`DropSelected` / `DropMenuOpened`).
- **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.
- **Fixes**: `SetBackdrop(Acrylic/Mica)` no longer covers the system material with opaque white when no tint is set; `ListView::SetItemHeight` is clamped to >=1px and Draw/hit-testing no longer divide by zero.
- **Docs/cleanup**: documented `HwndView` cross-process risks; removed the redundant `WM_ACTIVATE` check, added `<cstring>`, removed the demo's empty callback.
- **v1.24.0** (**contains breaking changes**):
- **Signal lifetime**: `ConnectionState::alive` is atomic; `Connection::disconnect` / receiver destruction logically cancels pending `UIThread` / `NewThread` tasks; `Fire` concurrent with signal destruction is explicitly UB.
- **Receiver context**: `UIElement` / `Window` derive from `ConnectionOwner`; `elem->Connect(...)` / `Connect(elem, ...)` / `sig.connect(elem, ...)` disconnect with the receiver; added free `Connect` and `ConnectWeak`.
- **Breaking**: `ZSignal` is neither copyable nor movable; member-function pointers use `Connect(elem, sig, &Class::Method)` / `ConnectWeak`; `elem->Connect(sig, &Class::Method)` is no longer supported.
- **Notes**: `Menu` / `MenuItem` / `Timer` still use `signal.connect` and do not auto-disconnect; signal arguments are passed as lvalues.
- **v1.25.0**:
- **New · `Drawer`**: left/right/top/bottom × Overlay / Push / Permanent; rounded scrim, rounded panel/border/outer shadow, Esc and outside-click dismiss.
- **New · `Window::AddKeyHandler / RemoveKeyHandler`**: temporary window-level key handlers.
- **Improvement**: `ScrollViewer` clip bleed follows the content `GetBleed()`; tests renamed to `zufyui_tests`, signal-focused and Drawer tests added (213 assertions).
- **v1.29.1**: fixed PageHost EaseOut reverse progress, animated hit-test transforms and page-removal indices; `OnPointerCancel` is wired to `WM_CANCELMODE/WM_CAPTURECHANGED` with an OLE drag-out exemption; `Opening`/`Opened` work again for menus and non-DWM windows.
- **v1.29.0**: pointer/focus/input feedback (cursor states, pointer cancel, TextBox focus styling/caret/password eye, ComboBox keyboard, Slider release, data-view/scrollbar/Expander cursors); window transitions (`SetTransitionDurations` / `PresentationState` / `DefaultWindowSetup`); menu `QueueToUIThread` and PageHost reverse navigation; Expander/SettingsList/chart font inheritance, MenuBar/Button/EnsureVisible fixes; API doc mojibake and chapter 8 title fixes.
- **v1.28.0**: nonblocking Present / high-refresh pacing (`SetNonBlockingPresent` / `SetDisplayFramePacing` / `GetDisplayRefreshHz`); private `IDWriteFontCollection`; UIA root/child provider teardown and `WM_DESTROY` event-map cleanup; menus opt into the same presentation policy by default.
- **v1.27.3**: popup window behavior. `Placement` (center owner/screen), `FollowOwner`, `MoveBounds` (owner client / monitor work area), `CloseReason`, `RequestClose/ForceClose` and close-veto signals; `SetMovable/SetCloseEnabled/SetCloseOnEscape`; custom title-bar buttons follow window policy; reliable popup first frame.
- **v1.27.2**:
- Window raw-pointer/UIA lifetime: `Window::ForgetElement` centralizes focus/pressed/capture/hover/tooltip/pending-repaint/UIA provider cleanup; `SetParent` detaches before release and `UiaDisconnectProvider` prevents the CFG crash.
- `TreeView::SetStretchLastColumn` (default on) fills the last column; SplitView button direction/disabled state, full-pane slide transition and collapse clamping; TrayIcon v3/v4 click fallbacks; Drawer close refresh; Card margins; password eye button; MessageBox sizing fix.
- **v1.27.1**: disabled the experimental independent render thread while preserving VBLANK frame sync; adapted context menus to non-DWM chrome; fixed stale menu-bar hover and menu placement after hiding the title bar or switching to the native frame; resize now submits a new frame immediately instead of leaving a transparent/stale picture.
- **v1.27.0**:
- **Windows 10 Acrylic**: enable `ACCENT_ENABLE_HOSTBACKDROP` before creating the HostBackdropBrush on Win10, preserving the custom blur/tint/noise chain; stop writing Win11-only DWM attributes on Win10.
- **DWM / Snap**: keep `DwmExtendFrameIntoClientArea({1,1,1,1})` for custom frames on both Win10 and Win11; reapply frame state after `WM_SIZE` / `WM_WINDOWPOSCHANGED`, fixing lost borders/shadows after Snap.
- **Render driver**: added `RenderDriver` / `SetRenderDriver()` / `GetActiveRenderDriver()` / `GetRenderDeviceName()`; the demo supports `--warp` / `--gpu` and a restart-based home-page switcher. WARP changes only application content rendering; DWM/Compositor may still use the GPU.
- **Breaking**: removed the public corner API `WindowCorner`, `SetWindowCorner()`, `GetWindowCorner()` and DSL `corner()`; Win10 stays square, Win11 follows DWM, and custom corners require calling Win32 DWM APIs directly.
- **Controls/demo**: title-bar glyphs fall back correctly to `Segoe MDL2 Assets` on Win10; the maximize button refreshes after Snap/restore; UI animation updates pause during drag/resize.
- **v1.26.0**:
- **Layout**: explicit Grid size constrains cell measurement; finite Row/Column main-axis allocation for Fill; Card/Page/ScrollViewer honour explicit sizes when empty; Button measures content with autoSize disabled; Label explicit width wraps; ScrollViewer no longer re-measures in Arrange.
- **UIA**: provider cache/context lifetime synchronized with COM callback threads, fixing CFG `FAST_FAIL_GUARD_ICALL_CHECK_FAILURE`.
- **Controls**: Expander first-expand/collapse-re-expand/clipping fixes; ToggleSwitch press-drag; Slider immediate drag, click/snap easing, `GetDisplayValue()`.Version digest
v1.15.0 → v1.29.1
Only the changes that affect your code are listed.
- v1.15.0: data-view virtualization (
SetItemCountetc.) + hide/filter/visible-order sort (two coordinate systems); cross-thread/locking hardening;ComboBoxsource-index API;TreeView::BeginUpdate/SetNodeText. - v1.17.0: UIA accessibility (on by default); external debug/automation channel (
SetDebugEnabled, off by default, commands 1~22); layout stretch weights (ColumnBox/RowBox/GridLayoutdistribute leftover by weight); automatic ellipsis tooltips (Label/Button);CaptionButton::Kind::Pin;TreeViewnodebgColor/Get/SetScrollOffsetY/ScrollToNode;Window::DefaultBackdropColorpure white. - v1.18.0:
- New
ZufyUICharts.h:ChartBase/BarChart/LineChart/PieChart;BarCharthorizontal orientation;PieChartwheel zoom. - New
TextEditmulti-line editor/viewer;TextRun; baseAcceptsTab(). UIElement::ReleaseDeviceResourcesRecursive();PageHostdelayed hidden-page cache release (~1.2 s);ScrollViewer::UseCache()=false;SetUseCache(false)frees immediately.- Library fixes:
SnapDPI scale also set on the UI thread;ZSignal::FireRAII exception safety;TextBoxshift+click;Sliderzero-width NaN guard;ListViewpooled-label re-measure on width change (poolW_). - v1.19.0:
- New drag & drop (
ZufyUIDragDrop.h):Window::BeginDrag+DragDataBuilder; elementSetDropTargetEnabled/OnDragEnter/Over/Leave/Drop+ signals;Label/Button/TextBox/TextEdit/ComboBoxaccept and start drags; drag files out to Explorer. - New
Expander(collapsible card: smoothstep easing + rotating arrow + header hover highlight),SettingsList(settings rows); image display usesLabel::SetImage+SetImageFit(scale to fully visible). ComboBoxdropdown arrow is now a chevron that rotates with expansion.- Text drag now has move semantics: the source deletes the original selection first, then inserts at the drop point (private format dedups same-control drags).
- v1.19.1:
TextEditundo/redo switched to the standard scheme (stack top = current state): both undo and redo restore the selection and cursor of that point; Backspace/Delete/typing/paste are one step each; drop insert/move are undoable and redoable.ScrollViewer: content is measured at the viewport width (fixes "clipped cards" and wrong scroll range from an infinite desired width for FillWidth/wrapping content); content is measured twice (re-measured at the narrower width once a vertical bar appears); the content element's ownmarginis honored; the clip gets a 1px bleed so edge borders are not cut in half.- The drop caret now shows even when the target is unfocused; during a drag the source selection is preserved and a preview caret shows at the drop point; dropping inside the original selection is a no-op.
Expander: header hover highlight (no longer covering the card border), arrow rotates with the collapse easing,SetIconleading icon.- Whole-window drag & drop:
Window::SetDropTargetEnabled+ window-levelDragEnter/DragOver/DragLeave/Drop. - Image display merged into
Label(newSetImageFit); the standaloneImageViewis removed. - v1.19.2:
- New top menu bar
MenuBar(VS-style: click opens theMenu; hovering only highlights, no auto-expand; the open entry stays pressed until the menu closes; overlaid on the custom title bar by default, empty areas pass through so the title bar stays draggable). - New bottom status bar
StatusBar(left/right panels: optional icon + text). Window:SetMenuBar/SetStatusBar/SetMenuBarInTitleBar/SetShowTitleText(title text and an on-title-bar menu are mutually exclusive).Menugains anonClosedcallback;MenuWindow::OnPopupClosed.- v1.19.3:
- New theme system (
ThemeRole/Theme/ThemeManager;Light/Dark/HighContrast; window-levelSetTheme;UIZSignals::ThemeChanged/ThemeReapply) — one palette by role; re-applied to the visible subtree on page/tab switch. - Follow system: reads the registry light/dark + system accent, handles
WM_SETTINGCHANGE/WM_THEMECHANGED/WM_DWMCOLORIZATIONCOLORCHANGED/WM_SYSCOLORCHANGE;ThemeManager::SetFollowSystem(bool). - Explicit instance color wins: once a control's
Set*Coloris called it is flagged "user-colored" and the theme no longer overrides it; ListView items / TableView cells+rich cells / TreeView cells / headers / alternating rows / Tab selected+hover / radio / NumberBox hover / CheckBox hover all themed. Backdroptoken (window base white/black); window periphery (caption buttons) follows the system theme;ThemeManager::Mapcolor remap.- Fixes:
ThemeReapplyconnection leak (UAF);SyncThemeBackdropswallowing user tint; ListView/TableView/TreeView theme overriding per-item colors. - v1.19.4:
- New DSL (
ZufyUIDsl.h):Ref<T>(with/on/add+ layout shortcuts),Make<T>,Col/Row/Gridand per-control short factories — fluent construction / subtree assembly / signal wiring; demo gains a "DSL" page. - Fix:
CheckBoxhard-codedwidth_/height_in its ctor → treated as a fixed width inRowBox/ColumnBoxand the label was clipped. ListView/TableViewRefreshChildrencache criteria collapsed into a single signatureChildrenSig()(criteria in one place, harder to forget); consistent withTreeView.ChartBase::MeasureOverride: falls back to420×260whenfillbut unconstrained/no size (no longer collapses to 0).Window::SetMinSizedefault content measure gets a 600 DIP width floor;pch.hZufyUI_DEBUGnow#ifdef _DEBUG;Theme::HighContrastrole colors distinguished (no longer all-yellow).- v1.19.5:
- DSL enhancements:
dsl::App()/WindowAppwindow builder (fluent config +run());Page()/Menu()/Settings()short factories; SFINAE-gated per-control sugar (text/checked/value/placeholder/padding/category/series/slice/item/menu). - The demo "DSL" page uses the sugar and chart composition (
Pie().slice(...),Bar().category(...).series(...),Progress().value(...)). - v1.19.6:
- Fix:
ListViewbutton mode checkbox hit test was 4px off (now aligned with the draw / child left edge). - Fix:
Label::MeasureOverridewrap branch ignored inline children width (wrapping Labels withAddChildsqueezed/overflowed text). - Docs: version is now a single source (
API.md/README.mdheaders reference theZufyUI.hmacro; the generatormdapi2html.pyinjects1.29.1); cleaned stale items (ImageViewdefault row,Sort→SortItems,Menu::onClosed, chart fill wording, README menu+90MBhistory entry);mdapi2html.pyfixes--theme autosemantics andc++-style language names in the code-fence regex. - v1.19.7:
- Fixes:
ChartBaseswapped horizontal/vertical scrollbar allowance (viewWuses the vertical bar,viewHthe horizontal) → rightmost/bottom content unreachable;NumberBoxwheel focus check (focus is on the innerTextBox);lastActiveAnimElements_dangling (erased from the anim sets on destruction, prevents random crashes);Menu::ShowAtthrowingbad_weak_ptrwhen not shared-owned;ChildrenSigmissingEnsureView;TreeView::SetDefaultExpandDepthnot applied byAddRoot/AddChild. - Fixes:
ColumnBox/RowBoxspacing counts only layout-participating children;GridLayoutrow/col count skips invisible;Labelwrap ignored/duplicated spacing;ListView/TableViewclearchildrenView_before releasing labels and release pooled/rich/cell labels;Window::defaultIMC_viaImmAssociateContext;DragData::GetFilesbufferlen+1;TextEditfiresSelectionChangedwhen clearing a selection;MessageBoxdefault title localized. - Added
TODO.md(merges the formerFEATURE_PLAN.md/OPTIMIZATION_PLAN.md; the single authoritative backlog). - v1.20.0:
- DSL:
root()now accepts anyLayoutsubclass (previously onlyColhad a dedicated overload, soRow/Gridfailed to compile becauseRef→shared_ptr<Layout>needs two user-defined conversions);titleBar/menuBar/statusBarlikewise take aRef<T>directly. - DSL:
add()dispatches on the container's real API (ColumnBox/RowBox/Label→AddChild;PageHost→AddPage, skipping non-Pagearguments;GridLayoutgoes through the new coordinate API). Addeddsl::Cell(row,col,child[,rowSpan,colSpan])andRef::cell, theapply()escape hatch, andWrap(). - DSL: more shortcuts — size limits (
minWidth/minHeight/maxWidth/maxHeight/minSize/maxSize), stretch weights (weight/hWeight/vWeight),cache/bleed/clipRect/noClip/cursor/dropTarget/contextMenuEnabled/accessible,spacing(single-arg onCol/Row, two-arg onGridLayout),padding(Thickness),background/textColor,align(GridLayout); per-control sugar gainedimage/imageFit/items/rows/cols/header/cell/root(s)/separator/submenu; new factoriesRadioGroup()/ScrollBar()/Glyph()(Imageis a resource object, not aUIElement, so it has no factory — use theLabel::SetImagesugar). - DSL:
WindowApp::run()now callsShow()—Window::Createdoes not show the window, so the previous implementation ran a message loop with no window (looked like a hang); addedhidden/minSize/position/frameRateLimit/theme/useAppTheme/dropTarget/icon/titleBarVisible/showTitleText/menuBarInTitleBarand the window signal hookon<&Window::Closed>(Window's signals are plain members, there is noConnect);WindowAppis now movable (it holds aunique_ptr<Window>, becauseWindowitself is neither copyable nor movable). - Fix: null guards in
ColumnBox/RowBox/GridLayout::AddChild— the DSL's variadic forwarding can passnullptr, which used to dereference a null pointer. - Fix:
ZufyUIWindowTool.hwas not self-contained — it usedLabel/Button/ColumnBox::AddChildwithout includingZufyUIWidgets.h, relying on the caller to include it first (pch.hhappened to do so); the include is now present and the header can be included on its own. - 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(adds a UTF-8 BOM only to C++ sources that contain non-ASCII and lack one, preventing the GBK misparse behindC2143/C2259/C2888/C4819), andtests/zufyui_tests.cpp+tools/run_tests.ps1(47 compile-time/runtime assertions, no window created, runnable from a shell or CI). - v1.21.0:
- Fix:
Cardflashed a blue hover border — the theme applier setSetHoverBorderColor(Accent)on cards, a behaviour cards never had; removed (hover still changes the background). - Fix:
ProgressBarinner fill radius no longer matched the outer frame after stretching — the track, the clip geometry and the border still used the memberheight_(construction-time height) while only the fill used the arranged height; all three now usearrangedRect_.height / 2. - Fix:
Buttoncaptions were ellipsized even with room to spare —MeasureOverridereturned a constantwidth_(set toDefaultWidth = 120in the constructor); it now grows to fit the text (max(width_, textWidth + 2*padding)), withButton::AutoSizeToText(static, defaulttrue) andSetAutoSizeToText(false). This is a layout behaviour change. - New:
ToggleSwitchuses duration-driven ease-in-out (DefaultAnimationDuration = 0.25s, stops exactly on time); also fixes mouse-click/keyboard paths that bypassedSetOnand therefore never started the animation (the "instant snap"). - New:
ProgressBarvalue easing (DefaultValueAnimDuration = 0.22s; fill and percentage text move together). - New:
SplitViewcollapse: dragging within the edge threshold first shows an "about to collapse" overlay (translucent accent + direction arrow, alpha fade, content untouched); the pane collapses on release (size eases to 0); afterwards a small button is drawn on top of the content at that edge (rounded light grey + arrow pointing in the expand direction + hover easing), and clicking it eases that side from 0 to its minimum limit.SetCollapseEnabled(false)disables the whole feature. Public API:SetCollapseEnabled/IsCollapseEnabled/SetCollapseThreshold/CollapseFirst/CollapseSecond/Expand/IsFirstCollapsed/IsSecondCollapsed/GetCollapsedSide/IsCollapsing/GetCollapseProgress/SetExpandButtonColors/SetExpandButtonSizeplus theCollapsedChanged(int)signal. - New:
detail::EaseOutCubic/detail::EaseInOutCubic(duration-driven easing, one shared convention for in-library animations). - New:
ThemeRole::Shadow(appended at the end of the enum so existing values keep their numbers) with Light/Dark/HighContrast values;UIElement::DefaultShadowColor/SetDefaultShadowColor;Window::SetBackdrop(Backdrop)follows the theme (thetintoverload means "locked") plus theApplyThemeToBackdropParamshook. - Fix:
PieChartCtrl+wheel zoom did nothing —PieChart's ownzoom_shadowsChartBase::zoom_, so delegating to the base only changed the base's copy; the pie now handles Ctrl itself viaSetZoom. Semantics are explicit: Ctrl+wheel = zoom / plain wheel = pan only. - Fix: chart wheel panning "did not move" — the wheel path was missing
SyncScrollPositions()(it changedscrollX_/scrollY_but never recomputedbaseX_/baseY_). - Fix: documented that
ColumnBoxarranges a child without an explicit width at the available width (horizontal stretch ignores the weight) — so "make a card hug its content" means wrapping it in aRow; and that aSettingsListplaced in aCard's built-inGridLayout(auto columns passFLT_MAX) degenerates to zero width — useSetLayout(Col(...))+SetFillWidth(true). - Tooling:
tests/zufyui_tests.cpp62 → 85 assertions (regressions for this batch: button auto-size on/off, label width follows text, progress/toggle easing convergence, SplitView collapse and expand-to-minimum). - v1.22.0 (contains breaking API changes):
- Fix:
MessageBox(and any modal) first click falling through to the window behind — when a modal is opened from insideWindow::OnMouseUp's slot, that function's trailingReleaseCapture()only runs after the modal loop ends, so the main window keepsSetCapturefor the whole modal and Windows routes mouse input to the capture window;Window::RunModalnow doesif (GetCapture()) ReleaseCapture();before entering the loop. - Fix:
ScrollViewerscroll chaining — it no longer swallows the wheel at the top/bottom (returnsfalseto bubble up the parent chain when that axis can't scroll further), so the outer page keeps scrolling. - Fix:
SplitViewexpand had no easing + expand button jumped sides — the oldExpand()cleared the collapsed flags before starting the animation, butPaneLengthskeyed off them; now a singlecollapseSide_drives both directions and is cleared only when the animation finishes. - Breaking · P0-1: member functions with default arguments split into non-defaulted overloads (so
.with()works):TreeView::SetCheckable(bool)+SetCheckableShallow(bool);SetNodeCheckable(node,bool)+SetNodeCheckableRecursive;SetNodeEnabled(node,bool)+SetNodeEnabledRecursive;SetNodeCheckState(node,state)+SetNodeCheckStateFull(...,updateChildren,updateParent);ListView::AddItem(text)and rich-itemAddItemWidget(shared_ptr<Label>)(old name dropped);RadioGroup::AddItem/AddItemSelected/AddButton/AddButtonSelected;Menu::AddCheckItem(text,checked)/AddCheckItemCb/AddCheckItemRadio. - New · P0-2: collision-free aliases
make_slider/make_card/make_page/make_menu/make_menu_bar/make_status_bar/make_radio_group/make_scroll_bar/make_expander. - New · P1-2:
Page::SetScrollableContent(content)— one line wraps the whole page in aScrollViewer+ margin. - New · P1-4:
ThemeManager::RegisterHook/RegisterSubtreeApplierreturn a RAIIHookHandle(auto-disconnect on destruction); the library's own fixed hooks useRegisterHookPermanent/RegisterSubtreeApplierPermanent. - Docs · P3: added
docs/pitfalls.md;AGENTS.mdgained a "chaining / API conventions" section. - v1.22.1:
- Fix (layout):
RowBox/ColumnBoxArrangeOverridedid not clamp each child'sbaseto its min/max before distributing leftover → a child withSetMinWidth/Heightpushed its extra space onto a stretching sibling, overflowing the row/column (classic case: aSetMinWidthlabel +SetFillWidthslider → the slider grew too long and spilled outside its card). Nowbase = clamp(base, min, max)before computing leftover. - Behaviour:
ColumnBox/RowBox/GridLayoutno longer shrink content — insufficient space now overflows and is left to an outerScrollViewer(desktop UI does not compress content).GridLayoutdropped its proportional row/column compression on overflow. - Fix (alignment):
GridLayout'sSetHorizontalAlignment/SetVerticalAlignmentnever took effect because the testcolStretchWeights.empty()was always false; now it checks "all zero", soCenter/Endwork (only when no column/row stretch weight is set). - Fix (text/IME):
TextBox/TextEditnow merge UTF-16 surrogate pairs (emoji / beyond-BMP) and insert them as one unit;←/→,Backspace,Deletemove/delete across the whole pair. On losing focus the control clears its own composition state and theWindowcancels the IME composition (ResetImeState()) — both control and program IME state reset.TextBox::SetImeEnabled(false)also clears composition. - Fix (accessibility):
GetAutomationIdOrAuto()now uses a per-window counter (Window::NextAccessibleAutoId()), so multi-window/multi-root ids no longer collide;ElementProviderFromPointdescends child-before-parent to the deepest hit (e.g. a Button embedded in a Label). - Fix: data view item/cell placement
bleedYis read from each element'sGetBleed()(no longer a fixed3.0f), so shadows/bleed aren't clipped;indicatorY_is initialised to-1so the selection indicator snaps on the first frame. - Fix (visual): the focus ring uses
ThemeRole::FocusRingandTheme::cornerRadius(was a hard-coded blue + fixed 4); inWM_NCHITTESTthe custom title-bar buttons take priority over the resize border (the maximize-button corner is no longer taken byHTTOPRIGHT→ Win11 Snap Layouts can appear). - Engineering:
pch.hno longer includes the library headers (editing a lib header no longer rebuilds the whole PCH); addedUIElement::MarkUserColor()centralising 40+ "user colour" markers; removed dead codeListView::FindEnabledFrom. - v1.23.0:
- New ·
ZufyUIHwndView.h(HwndView): native HWND content host. Because the main window is NRB+DComp (child HWNDs are not composited), it uses a top-level owned popup as the host;SetContentHwndre-parents the external window as itsWS_CHILD(cross-process allowed) and shows it. Moving the host moves the child natively; clipping = host client +SetWindowRgn(element rect ∩ window client ∩ ancestorGetClipRect, incl. theScrollViewerviewport). SupportsSetObscured,SetOnBoundsChanged,SetFill*. - New ·
Windowexternal-visual attachment:CreateExternalVisual()(WinRTContainerVisualinserted atop the root visual, for WebView2put_RootVisualTarget),SetExternalVisualBounds(DIP→physical px),RemoveExternalVisual;AddOverlaySync/RemoveOverlaySync/SyncOverlays(unified overlay sync). - Performance: overlay sync is now a single window-level point (
WM_MOVE/WM_SIZE/WM_DPICHANGEDimmediate + one shared 16ms fallback timer) instead of a per-instance timer; DPI/client cached; redundantSetWindowPosskipped andSWP_NOSIZE/NOMOVEused as appropriate; the demo's color pattern is cached into a DIB. - Fix ·
NumberBox: the empty-text error clears once the text becomes a valid number;ResetToDefaultforce-clears the error after notifying the app; step/clear buttons fire on press (no re-check against the moving rect; fixes staying red after the × button). - Fix · data-view fill:
ListView/TableView/TreeViewMeasureOverridehonoursSetFillWidth/SetFillHeight(like charts) instead of always returning the default 200/400. - Demo: new "Native HWND" page (GDI color pattern + Card/Grid/Column/ScrollViewer layouts + an out-of-process
--outprocproducer window hosted byHwndView). - v1.23.1:
- Fix (layout / hit-testing):
PageHost::MeasureOverridenow measures every page. PreviouslyPageHostonly arranged pages whilePage::Arrangere-measured solely on a size change, so page content made visible at runtime (e.g. anExpandercard revealed after a combo-box selection) was never re-measured: the new element kept a zeroarrangedRect(no border,HitTestfailed) until the window was resized. Clean pages hit theMeasurecache, so no duplicate work is added. - v1.23.2:
- Build: added
/bigobjto the Debug|Win32 / Debug|x64 configurations ofZufyUI.vcxproj/ZufyUIDebugger.vcxproj(Release already had it); the full Release/Debug matrix passes. - v1.23.3:
- Button: the internal
Labelis a real child now (rich content viaGetLabel()->AddChild/SetContent); added the drop 2x2 switches (SetDropWriteBack/SetDropOpenOnClick) and a single-select menu (DropSelected/DropMenuOpened). - 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. - Fixes:
SetBackdrop(Acrylic/Mica)no longer covers the system material with opaque white when no tint is set;ListView::SetItemHeightis clamped to >=1px and Draw/hit-testing no longer divide by zero. - Docs/cleanup: documented
HwndViewcross-process risks; removed the redundantWM_ACTIVATEcheck, added<cstring>, removed the demo's empty callback. - v1.24.0 (contains breaking changes):
- Signal lifetime:
ConnectionState::aliveis atomic;Connection::disconnect/ receiver destruction logically cancels pendingUIThread/NewThreadtasks;Fireconcurrent with signal destruction is explicitly UB. - Receiver context:
UIElement/Windowderive fromConnectionOwner;elem->Connect(...)/Connect(elem, ...)/sig.connect(elem, ...)disconnect with the receiver; added freeConnectandConnectWeak. - Breaking:
ZSignalis neither copyable nor movable; member-function pointers useConnect(elem, sig, &Class::Method)/ConnectWeak;elem->Connect(sig, &Class::Method)is no longer supported. - Notes:
Menu/MenuItem/Timerstill usesignal.connectand do not auto-disconnect; signal arguments are passed as lvalues. - v1.25.0:
- New ·
Drawer: left/right/top/bottom × Overlay / Push / Permanent; rounded scrim, rounded panel/border/outer shadow, Esc and outside-click dismiss. - New ·
Window::AddKeyHandler / RemoveKeyHandler: temporary window-level key handlers. - Improvement:
ScrollViewerclip bleed follows the contentGetBleed(); tests renamed tozufyui_tests, signal-focused and Drawer tests added (213 assertions). - v1.29.1: fixed PageHost EaseOut reverse progress, animated hit-test transforms and page-removal indices;
OnPointerCancelis wired toWM_CANCELMODE/WM_CAPTURECHANGEDwith an OLE drag-out exemption;Opening/Openedwork again for menus and non-DWM windows. - v1.29.0: pointer/focus/input feedback (cursor states, pointer cancel, TextBox focus styling/caret/password eye, ComboBox keyboard, Slider release, data-view/scrollbar/Expander cursors); window transitions (
SetTransitionDurations/PresentationState/DefaultWindowSetup); menuQueueToUIThreadand PageHost reverse navigation; Expander/SettingsList/chart font inheritance, MenuBar/Button/EnsureVisible fixes; API doc mojibake and chapter 8 title fixes. - v1.28.0: nonblocking Present / high-refresh pacing (
SetNonBlockingPresent/SetDisplayFramePacing/GetDisplayRefreshHz); privateIDWriteFontCollection; UIA root/child provider teardown andWM_DESTROYevent-map cleanup; menus opt into the same presentation policy by default. - v1.27.3: popup window behavior.
Placement(center owner/screen),FollowOwner,MoveBounds(owner client / monitor work area),CloseReason,RequestClose/ForceCloseand close-veto signals;SetMovable/SetCloseEnabled/SetCloseOnEscape; custom title-bar buttons follow window policy; reliable popup first frame. - v1.27.2:
- Window raw-pointer/UIA lifetime:
Window::ForgetElementcentralizes focus/pressed/capture/hover/tooltip/pending-repaint/UIA provider cleanup;SetParentdetaches before release andUiaDisconnectProviderprevents the CFG crash. TreeView::SetStretchLastColumn(default on) fills the last column; SplitView button direction/disabled state, full-pane slide transition and collapse clamping; TrayIcon v3/v4 click fallbacks; Drawer close refresh; Card margins; password eye button; MessageBox sizing fix.- v1.27.1: disabled the experimental independent render thread while preserving VBLANK frame sync; adapted context menus to non-DWM chrome; fixed stale menu-bar hover and menu placement after hiding the title bar or switching to the native frame; resize now submits a new frame immediately instead of leaving a transparent/stale picture.
- v1.27.0:
- Windows 10 Acrylic: enable
ACCENT_ENABLE_HOSTBACKDROPbefore creating the HostBackdropBrush on Win10, preserving the custom blur/tint/noise chain; stop writing Win11-only DWM attributes on Win10. - DWM / Snap: keep
DwmExtendFrameIntoClientArea({1,1,1,1})for custom frames on both Win10 and Win11; reapply frame state afterWM_SIZE/WM_WINDOWPOSCHANGED, fixing lost borders/shadows after Snap. - Render driver: added
RenderDriver/SetRenderDriver()/GetActiveRenderDriver()/GetRenderDeviceName(); the demo supports--warp/--gpuand a restart-based home-page switcher. WARP changes only application content rendering; DWM/Compositor may still use the GPU. - Breaking: removed the public corner API
WindowCorner,SetWindowCorner(),GetWindowCorner()and DSLcorner(); Win10 stays square, Win11 follows DWM, and custom corners require calling Win32 DWM APIs directly. - Controls/demo: title-bar glyphs fall back correctly to
Segoe MDL2 Assetson Win10; the maximize button refreshes after Snap/restore; UI animation updates pause during drag/resize. - v1.26.0:
- Layout: explicit Grid size constrains cell measurement; finite Row/Column main-axis allocation for Fill; Card/Page/ScrollViewer honour explicit sizes when empty; Button measures content with autoSize disabled; Label explicit width wraps; ScrollViewer no longer re-measures in Arrange.
- UIA: provider cache/context lifetime synchronized with COM callback threads, fixing CFG
FAST_FAIL_GUARD_ICALL_CHECK_FAILURE. - Controls: Expander first-expand/collapse-re-expand/clipping fixes; ToggleSwitch press-drag; Slider immediate drag, click/snap easing,
GetDisplayValue().