Class display is xpce's handle on the host's graphical
output: a physical monitor, the system theme, DPI, system clipboard and
the collection of frames currently hosted on that monitor. The
underlying driver is SDL3 across all platforms.
xpce creates a single instance at boot, bound to the primary monitor
and reachable as @display.
Additional display instances appear dynamically when a
hotplugged monitor is attached (and disappear on removal). Most
applications never reference any other display than
@display.
->inform
and
display->confirm.
Companion: display.value_font.->inform
/
display->confirm.|int]
=swipl-win / epilog.
If
@default, the
choice is derived from display<-system_theme.->bell.
.g.
"+0+0:1" picks monitor 1).<-area
available for application windows (the rest is reserved by the desktop, e.g.
for taskbars and docks).->create
and frame->unlink;
frames that have not been created yet do not appear here.
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.
<-area, display<-work_area
and
display<-dpi.
Called automatically on display events; can be invoked to refresh after
an external change..volume.
->busy_cursor
on every entry in display<-frames.
Used by
popup->execute
and click_gesture->terminate.->format.
See also
pce->format
and visual->report.
->report
messages on visual
objects. inform and error invoke display->inform; error
and warning also send
graphical->alert
to @reportee.
Status reports are ignored.->dispatch to
dispatch events for about 1/4 of a second.
primary or clipboard)
with the given textual value.auto lets SDL decide based on whether a physical
keyboard is attached.|int<-inspect_handlers
(using chain->add).
<-contained_in
protocol.<-contains
protocol.<-area.<-area.<-area.->dpi,
the override from the class variable,
or the value SDL reports for the monitor.SDL_GetSystemTheme().
Some platforms cannot report this reliably.swipl-win (epilog). Derived
from the class variable;
if that is @default,
derived from
display<-system_theme.
Setting it to a non-@default
value causes
use_module(library(theme/Theme)) to be loaded.clipboard).
Pair with display->copy
and display->selection.
which defaults to
primary; common alternatives are clipboard and secondary.
target is the requested MIME-like type (default text;
utf8_string for explicit UTF-8). type is the
xpce type the returned value should be coerced to via type<-check.