Guide API
Skip to main content

Module app

Module app 

Source
Expand description

The application layer: Program, the application root that owns the single event loop, the timer queue, and the capture stack that powers modal dialogs; and Application, a thin wrapper over it that adds window tiling/cascading and shell suspend.

Guide: The event loop in depth.

§Turbo Vision heritage

Ports TProgram / TApplication (tprogram.cpp, tapplica.cpp). The TApplication : TProgram inheritance becomes embed-and-delegate composition (deviation D2) — one type holds the other and forwards to it.

Structs§

Application
A thin embed-and-delegate wrapper over Program.
ModalFrame
A capture handler that realizes modality: while it is on the CaptureStack, positional (mouse) events are gated by bounds. Inside, they Pass to normal routing; outside, the frame returns Consumed. In practice an outside click never reaches the frame: pump_once runs an outside-click redirect first, which hands the event, localized, to the modal view alone (a history window closes on it, a plain dialog ignores it).
Program
The live event loop and application root.