Skip to content

fontlabapp.fontui.appshell

appshell

AppShell: the window every studio app shares.

What: one owned window with a resizable splitter, a tab per task, an optional embedded preview (TGlyph on the right, or TMetrics on top) and a status line. The shell owns the content-driven initial window size and title; embedded widgets never size or title themselves. Later user resizing is retained.

Edits: host-mode tab writes go through AppShell.history(label, glyphs, ...). It first calls core.edit_guards.require_history_scope and then the existing core.history commit path, so every write is one named Undo step on the explicit live layers the caller passes. A refusal or a partial write never raises out of a button: its message goes to the status line.

Use: shell = show_app("Kerning Studio", preview="tmetrics", tabs=[TabSpec(...)]). A tab spec is any object with title and build(shell); build returns an Owned (closed with the shell) or a plain widget.

Classes

Complete member index

Every captured member retains its own identity. Identical captured declaration text is linked once; this does not establish native inheritance or interchangeable objects.

Member Kind Signature Summary
HEIGHT_SHARE attribute
NO_FONT_TEXT attribute
PREVIEWS attribute
READY_TEXT attribute
WIDTH_SHARE attribute
available_geometry function (widget: Any) -> Any The available screen rectangle for <code>widget</code> (Qt 5 desktop or Qt 6 screen).
show_app function (title: str, preview: str | None=None, tabs: Sequence[Any]=(), *, parent: Any=None, package: Callable[[], Any… Build, size, title and show an <code>AppShell</code>; return it.