gtkmm 4.16.0
|
Object representing an output. More...
#include <gdkmm/monitor.h>
Public Member Functions | |
Monitor (Monitor &&src) noexcept | |
Monitor & | operator= (Monitor &&src) noexcept |
~Monitor () noexcept override | |
GdkMonitor * | gobj () |
Provides access to the underlying C GObject. | |
const GdkMonitor * | gobj () const |
Provides access to the underlying C GObject. | |
GdkMonitor * | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
Glib::RefPtr< Display > | get_display () |
Gets the display that this monitor belongs to. | |
Glib::RefPtr< const Display > | get_display () const |
Gets the display that this monitor belongs to. | |
void | get_geometry (Rectangle &geometry) const |
Retrieves the size and position of the monitor within the display coordinate space. | |
int | get_width_mm () const |
Gets the width in millimeters of the monitor. | |
int | get_height_mm () const |
Gets the height in millimeters of the monitor. | |
Glib::ustring | get_manufacturer () const |
Gets the name or PNP ID of the monitor's manufacturer. | |
Glib::ustring | get_model () const |
Gets the string identifying the monitor model, if available. | |
Glib::ustring | get_connector () const |
Gets the name of the monitor's connector, if available. | |
int | get_scale_factor () const |
Gets the internal scale factor that maps from monitor coordinates to device pixels. | |
double | get_scale () const |
Gets the internal scale factor that maps from monitor coordinates to device pixels. | |
int | get_refresh_rate () const |
Gets the refresh rate of the monitor, if available. | |
SubpixelLayout | get_subpixel_layout () const |
Gets information about the layout of red, green and blue primaries for pixels. | |
bool | is_valid () const |
Returns true if the monitor object corresponds to a physical monitor. | |
Glib::ustring | get_description () const |
Gets a string describing the monitor, if available. | |
Glib::SignalProxy< void()> | signal_invalidate () |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_description () const |
A short description of the monitor, meant for display to the user. | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Display > > | property_display () const |
The Gdk::Display of the monitor. | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_manufacturer () const |
The manufacturer name. | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_model () const |
The model name. | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_connector () const |
The connector name. | |
Glib::PropertyProxy_ReadOnly< int > | property_scale_factor () const |
The scale factor. | |
Glib::PropertyProxy_ReadOnly< double > | property_scale () const |
The scale of the monitor. | |
Glib::PropertyProxy_ReadOnly< Gdk::Rectangle > | property_geometry () const |
The geometry of the monitor. | |
Glib::PropertyProxy_ReadOnly< int > | property_width_mm () const |
The width of the monitor, in millimeters. | |
Glib::PropertyProxy_ReadOnly< int > | property_height_mm () const |
The height of the monitor, in millimeters. | |
Glib::PropertyProxy_ReadOnly< int > | property_refresh_rate () const |
The refresh rate, in milli-Hertz. | |
Glib::PropertyProxy_ReadOnly< SubpixelLayout > | property_subpixel_layout () const |
The subpixel layout. | |
Glib::PropertyProxy_ReadOnly< bool > | property_valid () const |
Whether the object is still valid. | |
Static Public Member Functions | |
static GType | get_type () |
Get the GType for this class, for use with the underlying GObject type system. | |
Protected Member Functions | |
Monitor () | |
Related Symbols | |
(Note that these are not member symbols.) | |
Glib::RefPtr< Gdk::Monitor > | wrap (GdkMonitor *object, bool take_copy=false) |
A Glib::wrap() method for this object. | |
Object representing an output.
Gdk::Monitor objects represent the individual outputs that are associated with a Gdk::Display. Display has APIs to enumerate monitors with Display::get_n_monitors() and Display::get_monitor() and to find particular monitors with Display::get_monitor_at_surface().
|
noexcept |
|
overridenoexcept |
|
protected |
Glib::ustring Gdk::Monitor::get_connector | ( | ) | const |
Gets the name of the monitor's connector, if available.
These are strings such as "eDP-1", or "HDMI-2". They depend on software and hardware configuration, and should not be relied on as stable identifiers of a specific monitor.
Glib::ustring Gdk::Monitor::get_description | ( | ) | const |
Gets a string describing the monitor, if available.
This can be used to identify a monitor in the UI.
Glib::RefPtr< Display > Gdk::Monitor::get_display | ( | ) |
Gets the display that this monitor belongs to.
Gets the display that this monitor belongs to.
Retrieves the size and position of the monitor within the display coordinate space.
The returned geometry is in ”application pixels”, not in ”device pixels” (see get_scale()).
geometry | A Gdk::Rectangle to be filled with the monitor geometry. |
int Gdk::Monitor::get_height_mm | ( | ) | const |
Gets the height in millimeters of the monitor.
Glib::ustring Gdk::Monitor::get_manufacturer | ( | ) | const |
Gets the name or PNP ID of the monitor's manufacturer.
Note that this value might also vary depending on actual display backend.
The PNP ID registry is located at https://uefi.org/pnp_id_list.
Glib::ustring Gdk::Monitor::get_model | ( | ) | const |
Gets the string identifying the monitor model, if available.
int Gdk::Monitor::get_refresh_rate | ( | ) | const |
Gets the refresh rate of the monitor, if available.
The value is in milli-Hertz, so a refresh rate of 60Hz is returned as 60000.
double Gdk::Monitor::get_scale | ( | ) | const |
Gets the internal scale factor that maps from monitor coordinates to device pixels.
This can be used if you want to create pixel based data for a particular monitor, but most of the time you’re drawing to a surface where it is better to use Gdk::Surface::get_scale() instead.
int Gdk::Monitor::get_scale_factor | ( | ) | const |
Gets the internal scale factor that maps from monitor coordinates to device pixels.
On traditional systems this is 1, but on very high density outputs it can be a higher value (often 2).
This can be used if you want to create pixel based data for a particular monitor, but most of the time you’re drawing to a surface where it is better to use Gdk::Surface::get_scale_factor() instead.
SubpixelLayout Gdk::Monitor::get_subpixel_layout | ( | ) | const |
Gets information about the layout of red, green and blue primaries for pixels.
|
static |
Get the GType for this class, for use with the underlying GObject type system.
int Gdk::Monitor::get_width_mm | ( | ) | const |
Gets the width in millimeters of the monitor.
|
inline |
Provides access to the underlying C GObject.
|
inline |
Provides access to the underlying C GObject.
GdkMonitor * Gdk::Monitor::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
bool Gdk::Monitor::is_valid | ( | ) | const |
Returns true
if the monitor object corresponds to a physical monitor.
The monitor becomes invalid when the physical monitor is unplugged or removed.
true
if the object corresponds to a physical monitor. Glib::PropertyProxy_ReadOnly< Glib::ustring > Gdk::Monitor::property_connector | ( | ) | const |
The connector name.
Default value: ""
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gdk::Monitor::property_description | ( | ) | const |
A short description of the monitor, meant for display to the user.
Default value: ""
Glib::PropertyProxy_ReadOnly< Glib::RefPtr< Display > > Gdk::Monitor::property_display | ( | ) | const |
The Gdk::Display
of the monitor.
Glib::PropertyProxy_ReadOnly< Gdk::Rectangle > Gdk::Monitor::property_geometry | ( | ) | const |
The geometry of the monitor.
Glib::PropertyProxy_ReadOnly< int > Gdk::Monitor::property_height_mm | ( | ) | const |
The height of the monitor, in millimeters.
Default value: 0
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gdk::Monitor::property_manufacturer | ( | ) | const |
The manufacturer name.
Default value: ""
Glib::PropertyProxy_ReadOnly< Glib::ustring > Gdk::Monitor::property_model | ( | ) | const |
The model name.
Default value: ""
Glib::PropertyProxy_ReadOnly< int > Gdk::Monitor::property_refresh_rate | ( | ) | const |
The refresh rate, in milli-Hertz.
Default value: 0
Glib::PropertyProxy_ReadOnly< double > Gdk::Monitor::property_scale | ( | ) | const |
The scale of the monitor.
Default value: 1
Glib::PropertyProxy_ReadOnly< int > Gdk::Monitor::property_scale_factor | ( | ) | const |
The scale factor.
The scale factor is the next larger integer, compared to Gdk::Surface::property_scale().
Default value: 1
Glib::PropertyProxy_ReadOnly< SubpixelLayout > Gdk::Monitor::property_subpixel_layout | ( | ) | const |
The subpixel layout.
Default value: Gdk::SubpixelLayout::UNKNOWN
Glib::PropertyProxy_ReadOnly< bool > Gdk::Monitor::property_valid | ( | ) | const |
Whether the object is still valid.
Default value: true
Glib::PropertyProxy_ReadOnly< int > Gdk::Monitor::property_width_mm | ( | ) | const |
The width of the monitor, in millimeters.
Default value: 0
Glib::SignalProxy< void()> Gdk::Monitor::signal_invalidate | ( | ) |
void on_my_invalidate()
Flags: Run First
Emitted when the output represented by monitor gets disconnected.
|
related |
A Glib::wrap() method for this object.
object | The C instance. |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |