- display ->initialise: name=name,
area=area
- Create a display for the monitor with the given OS-reported name and
area. @display
and any additional hotplugged displays are created automatically;
applications normally do not call this.
- display ->unlink:
- Detach the display from @display_manager.
Invoked by the display-manager when the monitor is removed.
- display ->removed:
- Mark the display as hotplug-removed. Existing frames keep running until
they are destroyed; no new frames are accepted.
- display ->poll_dimensions:
- Re-query the OS for the monitor's display
<-area, display<-work_area
and
display<-dpi.
Called automatically on display events; can be invoked to refresh after
an external change.
- display ->bell: volume=[0..100]
- Ring the bell on this display. Volume defaults to
display
.volume.
- See also
- - display
.volume
- frame->bell
- graphical->bell
- display ->busy_cursor: cursor=[cursor]*,
block_input=[bool]
- Define (temporary) cursor for all frames on the display by calling
frame
->busy_cursor
on every entry in display<-frames.
Used by
popup->execute
and click_gesture->terminate.
- display ->confirm: for=[visual],
title=[char_array], message=char_array, any ...
- Format a string from the arguments and display a modal dialog asking the
user to confirm. Returns success on confirm, failure on cancel.
- See also
- - pce
->confirm
- string->format
- display->inform
- display ->inform: for=[visual],
title=[char_array], message=char_array, any ...
- Display a modal information dialog and wait for the user to dismiss it.
The first argument is a format string; the remaining arguments are
substituted via string
->format.
See also
pce->format
and visual->report.
- See also
- - pce
->inform
- string->format
- graphical->alert
- display->confirm
- display ->report: kind={status,inform,progress,done,warning,error,fatal},
format=[char_array], argument=any ...
- Catch-all for display
->report
messages on visual
objects. inform and error invoke display->inform; error
and warning also send
graphical->alert
to @reportee.
Status reports are ignored.
- display ->dispatch:
- Invoke display_manager
->dispatch to
dispatch events for about 1/4 of a second.
- See also
- display_manager
->dispatch
- display ->event_queued:
- Succeeds if there are events waiting in the OS queue for this display.
Does not handle them.
- display ->copy: char_array
- Place the argument on both the primary selection and the system
clipboard.
- display ->selection: which=[name],
value=char_array
- Become owner of the selection (
primary or clipboard)
with the given textual value.
- display ->screen_saver: bool
- Activate (@on)
or inhibit (@off)
the OS screensaver while xpce is running.
- display ->screen_keyboard: [{auto,on,off}]
- Policy for showing the on-screen keyboard when a text-input widget gains
focus.
auto lets SDL decide based on whether a physical
keyboard is attached.
- display ->dpi: size
|int - Override the display's reported resolution in dots per inch. Useful when
the OS misreports DPI for high-density screens.
- display ->inspect_handler: handler
- Add a handler to display
<-inspect_handlers
(using chain->add).
- See also
- - topic Finding References
- display<-inspect_handlers
- display ->has_visible_frames:
- Succeeds if at least one frame on this display is currently visible.
