datumhue.wm

Terminate a managed descendant app (silent no-op if already gone).

Set the caller's cursor override (effective only while it manages the focused app); nil clears.

Minimize or restore a managed app. Raises for an app living in an element of its parent (see app.spawn), which hides and shows with the element.

Set the position/size of a managed app. For an app living in another app's window (see app.spawn), the position is measured from that window's top-left. Raises for an app living in an element of its parent, which fills the element.

Give input focus to a managed app. The root app is the workstation's base layer: focusing it gives it input without covering the windows it manages, and its popovers stack above them.

Set a managed app's layout weight.

Reserve key chords and gamepad buttons for on_press, hiding them from this app and every app it manages. While subscribed, a press the grab takes, made while this app or an app it manages is focused, queues on_press; the press, its repeats and its release then reach nothing else in this app or the apps it manages: not their input reads, action bindings, input.on_key, input.on_text or input.on_button, their widgets, focus navigation or cancel requests. A chord takes a press of its key made while exactly its modifiers are held; a modifier pressed alone is never grabbed. When this app and one above it grab the same input, the one nearer the root takes it. A grab made while the input is held applies from its next press. Raises for a grab of nothing and for a chord or gamepad button that cannot be grabbed, naming the rule. on_release, when given, runs as each held sequence of presses the grab took ends. :unsubscribe() releases the grab.

Wrap a managed app in a decoration frame; returns the frame's root UiElement. An app living in another app's window (see app.spawn) is lifted out into the frame, which takes the place it showed at and stacks above every window. Removing the frame hands the app back unwrapped, at the top level at the frame's bounds; the decorations built on the frame go with it. A press in the frame's window reaches you as app_frame_pressed for the wrapped app after the focus it moved there: a press in an app living in that window focuses that app first, with its app_focused before, so focusing the wrapped app in answer takes focus back from it. Raises for an app living in an element of its parent (see app.spawn): a window manager never wraps one.

Change the frame insets of an already-wrapped managed app. Raises when the app has no frame; does nothing once the app has ended.

Deliver a cancel request to a managed app, as the browser's Back or a phone's back gesture would: its source is "system", and it goes through the app's chain from its focused element (from its content area when it has no focus), then on to the frame it is wrapped in, usually the caller's own (for an app living in another app's window, the frame around that window; for one living in an element of its parent, up through the parent from that element first), in the same frame. The browser's history is never touched. Raises for an app the caller cannot manage; a silent no-op when the app has ended.