strand

window

element window: surface

A window the compositor manages (xdg_toplevel): it tiles, floats, moves, minimises and shows in task bars as an app's window does (a settings window, a picker). The compositor decides its size: its width and height (its content's while unset) are the size it asks for, and its min_*/max_* the sizes it takes. Its compositor's close writes its open: <-> x false. Its own focused is true while the compositor has it focused, and maximized, fullscreen, tiled and decorated follow the compositor (id: w and w.maximized); w.move(), w.resize(edge), w.minimize(), w.maximize(), w.fullscreen() and w.close() ask it. The compositor places, stacks and focuses it, so the surface props that place a layer surface (screens, layer, anchor, keyboard, attach, scrim, and margin on it) are load errors (check::window_prop), and screen is not in scope in it. Escape and focus loss leave it open; only the compositor's close and w.close() write its open false.

It is a surface, written at the top level of a file.

Also every prop and event of surface.

PropType
titletextThe title the compositor shows: title: "Settings". Its name while unset.
app_idtextThe app id compositor rules match: strand-<Name> while unset.
decorationsDecorationsWho draws its title bar and borders: server (the default), the compositor where it offers to (w.decorated), or none, the config.

This page as Markdownllms.txt