1.45.2 Instance variables

display <-> name: name

Human-readable name reported by the OS for this monitor.

display <- number: int

Numeric identity assigned to the monitor; stable across the life of the process and used by the geometry syntax (e.g. "+0+0:1" picks monitor 1).

display <-> primary: bool

@on when this display is the OS-designated primary monitor. Exactly one display has this set at any time.

display <- area: area

Pixel rectangle occupied by this monitor in the global desktop coordinate space.

display <- work_area: area

Subrectangle of display<-area available for application windows (the rest is reserved by the desktop, e.g. for taskbars and docks).

display <- frames: chain

Chain of all frames currently hosted on this display. Maintained by frame->create and frame->unlink; frames that have not been created yet do not appear here.

See also

- frame->create
- class frame

display <- display_manager: display_manager

The global display manager (@display_manager).

See also

class display_manager

display <-> foreground: colour

Initial foreground colour for newly created windows. Changing this does not affect existing windows.

display <-> background: colour

Initial background colour for newly created windows. Changing this does not affect existing windows.

See also

window->background

display <- inspect_handlers: chain

Chain of handler objects used to support debugging tools. When an event occurs on a window and this chain is non-empty, the handlers in this chain are tried before the normal event-handling procedure.

xpce searches for the deepest nested graphical that overlaps the event-position. A possible event focus is ignored. If the event matches the type of the handler, the message of the handler is executed with the following argument binding:

@receiver	The graphical
@arg1	Idem
@arg2	The event

If this message succeeds, the event is considered to be dealt with.

See also

- tool Inspector
- display->inspect_handler