Struct MONITORS

pub struct MONITORS;

Monitors service.

List monitor screens and configure the PPI of a given monitor.

Uses

Uses of this service:

Start Position

Windows are positioned on a virtual screen that overlaps all monitors, but all position configuration is done relative to an specific parent monitor, it is important to track the parent monitor as it defines properties that affect the layout of the window. This service is used to provide information to implement this feature.

Fullscreen

To set a window to fullscreen a monitor must be selected, by default it can be the one the window is at but the users may want to select a monitor. To enter fullscreen exclusive the video mode must also be decided, all video modes supported by the monitor are available in the MonitorInfo value.

Real-Size Preview

Some apps, like image editors, may implement a feature where the user can preview the real dimensions of the content they are editing, to accurately implement this you must known the real dimensions of the monitor screen, unfortunately this information is not provided by display drivers. You can ask the user to measure their screen and set the pixel-per-inch ratio for the screen using the ppi variable, this value is then available in the LayoutMetrics for the next layout. If not set, the default is 96.0ppi.

Provider

This service is provided by the WindowManager.

Implementations

impl MONITORS

pub fn monitor(&self, monitor_id: MonitorId) -> Option<MonitorInfo>

Get monitor info.

Returns None if the monitor was not found or the app is running in headless mode without renderer.

pub fn available_monitors(&self) -> Vec<MonitorInfo>

Iterate over all available monitors.

Is empty if no monitor was found or the app is running in headless mode without renderer.

pub fn primary_monitor(&self) -> Option<MonitorInfo>

Gets the monitor info marked as primary.