TeachingTip

Logical requested open state, not animation-complete or QWidget visibility.

Policy controlling outside-click, escape, or programmatic close behavior.

Whether the overlay blocks interaction outside itself.

Whether a dim/scrim layer is shown behind the overlay.

Scrim opacity in [0, 1]; -1 uses the theme smoke token. Only applies when dim is enabled.

Cached content-backdrop blur radius in logical pixels [0, 32]; 0 disables blur. Defaults to 4 for modal surfaces and 0 otherwise until explicitly set. Explicit values, including 0, persist across modality changes.

Whether popup open/close transitions are animated.

Popup open/close animation progress.

Logical requested open state, not animation-complete or QWidget visibility.

Policy controlling outside-click, escape, or programmatic close behavior.

Policy controlling outside-click, escape, or programmatic close behavior.

Whether the overlay blocks interaction outside itself.

Whether the overlay blocks interaction outside itself.

When true, a CloseOnPressOutside light-dismiss SWALLOWS the dismissing press instead of letting it fall through to whatever is underneath — ComboBox-dropdown semantics (one click only closes the popup; it does not also activate the control beneath). Default false keeps the menu-style behaviour where the dismiss click still hits its target.

Regions exempt from the consume above: a dismissing press that lands inside one of these widgets still falls through to it, so a sibling toolbar / nav bar stays one-click reachable while the popup closes. Only meaningful together with lightDismissConsumesPress.

Whether a dim/scrim layer is shown behind the overlay.

Whether a dim/scrim layer is shown behind the overlay.

Scrim opacity in [0, 1]; -1 uses the theme smoke token. Only applies when dim is enabled.

Scrim opacity in [0, 1]; -1 uses the theme smoke token. Only applies when dim is enabled.

Cached content-backdrop blur radius in logical pixels [0, 32]; 0 disables blur. Defaults to 4 for modal surfaces and 0 otherwise until explicitly set. Explicit values, including 0, persist across modality changes.

Cached content-backdrop blur radius in logical pixels [0, 32]; 0 disables blur. Defaults to 4 for modal surfaces and 0 otherwise until explicitly set. Explicit values, including 0, persist across modality changes.

Whether popup open/close transitions are animated.

Whether popup open/close transitions are animated.

When false, close() skips the exit (fade-out) animation and hides instantly; the open/enter animation is unaffected. Lets a caller drop just the dismissal animation for a specific popup without touching the shared default — e.g. when the opacity-effect fade-out misbehaves over a native vibrancy backdrop on macOS.

Uses a widget as the local theme source when no anchor drives the popup.

Popup open/close animation progress.

Popup open/close animation progress.

Positions the popup's top-left in the given widget's local coordinates; with relativeTo == topLevelWidget this is window-relative. Coordinates reference the visible card corner; open() compensates the shadow margin. While open, the popup follows relativeTo and closes when it is fully clipped. Without a call, open() centers the popup.

Logical requested open state, not animation-complete or QWidget visibility.

Refreshes the cached backdrop after application content changes behind an open popup.

Closes with an explicit reason; close() uses Programmatic unless a reason is pending.

Logical requested open state, not animation-complete or QWidget visibility.

Opening transition started. Compatibility alias: aboutToShow().

Closing transition started. aboutToHide() is the parameterless compatibility alias.

Popup open/close animation progress.

Policy controlling outside-click, escape, or programmatic close behavior.

Whether the overlay blocks interaction outside itself.

Whether a dim/scrim layer is shown behind the overlay.

Scrim opacity in [0, 1]; -1 uses the theme smoke token. Only applies when dim is enabled.

Cached content-backdrop blur radius in logical pixels [0, 32]; 0 disables blur. Defaults to 4 for modal surfaces and 0 otherwise until explicitly set. Explicit values, including 0, persist across modality changes.

Whether popup open/close transitions are animated.

• NoAutoClose = 0
• CloseOnPressOutside = 1 << 0
• CloseOnEscape = 1 << 1

Why an overlay closed.

• Programmatic = 0
• ActionButton = 1
• CloseButton = 2
• LightDismiss = 3
• TargetDestroyed = 4
• Escape = 5

Updates the global theme and notifies active FluentElement instances.

Schedules a visible-first batched theme refresh without blocking the current interaction.

Returns the currently active global theme.

Returns whether a theme uses dark-backed chrome and material tokens.

Re-broadcasts the current theme to repaint after a design-token change.

Monotonic counter bumped on every theme change, for staleness checks.

Resolves the theme used by this element, honoring an inherited QWidget override.

Returns whether this element's effective theme uses dark-backed chrome.

Component-facing token accessors.

Returns this element's authored overrides.

Restores all token fields to global theme defaults.

Non-copying access to the active color set (for hot paint paths).

Material, elevation, and adaptive layout tokens.

Window-chrome backdrop color for the given activation state.

Called after the global theme changes.

Global visual theme used when resolving design tokens.

• Light = 0
• Dark = 1
• HighContrast = 2

Design token snapshots returned to components.

Returns mutable anchors for the QWidget host.

Applies a named state, or clears state when name is empty.

Registers or replaces a named state definition.

Reevaluates conditions; the first registered true condition wins.

Returns the lazy host-owned state observation object.

Replaces all host anchors and invalidates the parent layout.

Clears all host anchors and invalidates the parent layout.

Binds a source property to a property on the QWidget host.

Installs a managed direct binding on this QWidget host.

Installs an explicit-dependency C++ expression on this QWidget host.

Registers a state transition in precedence order.

Sets the default animation for this host's managed property writes.

Removes the default animation for future managed writes.

Writes a host property through Behavior without removing its binding.