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

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

Language

API reference / v1.29.1

Version digest

v1.15.0 → v1.29.1

Download Markdown

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().
View sourcedocs/src/API.en.md