class Gdk::Monitor


Gdk::Monitor objects represent the individual outputs that are associated with a Gdk::Display.

Gdk::Display keeps a GListModel to enumerate and monitor monitors with Gdk::Display#monitors. You can use Gdk::Display#monitor_at_surface to find a particular monitor.

Defined in:



Class Method Summary

Instance Method Summary

Instance methods inherited from class GObject::Object

==(other : self) ==, bind_property(source_property : String, target : GObject::Object, target_property : String, flags : GObject::BindingFlags) : GObject::Binding bind_property, bind_property_full(source_property : String, target : GObject::Object, target_property : String, flags : GObject::BindingFlags, transform_to : GObject::Closure, transform_from : GObject::Closure) : GObject::Binding bind_property_full, data(key : String) : Pointer(Void) | Nil data, finalize finalize, freeze_notify : Nil freeze_notify, getv(names : Enumerable(String), values : Enumerable(_)) : Nil getv, hash(hasher) hash, notify(property_name : String) : Nil notify, notify_by_pspec(pspec : GObject::ParamSpec) : Nil notify_by_pspec, notify_signal notify_signal, property(property_name : String, value : _) : Nil property, qdata(quark : UInt32) : Pointer(Void) | Nil qdata, ref_count : UInt32 ref_count, run_dispose : Nil run_dispose, set_data(key : String, data : Pointer(Void) | Nil) : Nil set_data, set_property(property_name : String, value : _) : Nil set_property, steal_data(key : String) : Pointer(Void) | Nil steal_data, steal_qdata(quark : UInt32) : Pointer(Void) | Nil steal_qdata, thaw_notify : Nil thaw_notify, to_unsafe : Pointer(Void) to_unsafe, watch_closure(closure : GObject::Closure) : Nil watch_closure

Constructor methods inherited from class GObject::Object

cast(obj : GObject::Object) : self cast, new(pointer : Pointer(Void), transfer : GICrystal::Transfer)
, newv(object_type : UInt64, parameters : Enumerable(GObject::Parameter)) : self newv

Class methods inherited from class GObject::Object

cast?(obj : GObject::Object) : self | Nil cast?, compat_control(what : UInt64, data : Pointer(Void) | Nil) : UInt64 compat_control, g_type : UInt64 g_type, interface_find_property(g_iface : GObject::TypeInterface, property_name : String) : GObject::ParamSpec interface_find_property, interface_list_properties(g_iface : GObject::TypeInterface) : Enumerable(GObject::ParamSpec) interface_list_properties

Macros inherited from class GObject::Object

previous_vfunc(*args) previous_vfunc, previous_vfunc!(*args) previous_vfunc!, signal(signature) signal

Constructor Detail

def #

Initialize a new Monitor.

[View source]
def*, connector : String | Nil = nil, display : Gdk::Display | Nil = nil, geometry : Gdk::Rectangle | Nil = nil, height_mm : Int32 | Nil = nil, manufacturer : String | Nil = nil, model : String | Nil = nil, refresh_rate : Int32 | Nil = nil, scale_factor : Int32 | Nil = nil, subpixel_layout : Gdk::SubpixelLayout | Nil = nil, valid : Bool | Nil = nil, width_mm : Int32 | Nil = nil) #

[View source]

Class Method Detail

def self.g_type : UInt64 #

Returns the type id (GType) registered in GLib type system.

[View source]

Instance Method Detail

def ==(other : self) #
Description copied from class Reference

Returns true if this reference is the same as other. Invokes same?.

def connector : String | Nil #

Gets the name of the monitor's connector, if available.

[View source]
def display : Gdk::Display #

Gets the display that this monitor belongs to.

[View source]
def display=(value : Gdk::Display | Nil) : Gdk::Display | Nil #

[View source]
def geometry : Gdk::Rectangle #

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 Gdk::Monitor#scale_factor).

[View source]
def hash(hasher) #
Description copied from class Reference

See Object#hash(hasher)

def height_mm : Int32 #

Gets the height in millimeters of the monitor.

[View source]
def invalidate_signal #

[View source]
def is_valid : Bool #

Returns true if the monitor object corresponds to a physical monitor.

The monitor becomes invalid when the physical monitor is unplugged or removed.

[View source]
def manufacturer : String | Nil #

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

[View source]
def model : String | Nil #

Gets the string identifying the monitor model, if available.

[View source]
def refresh_rate : Int32 #

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.

[View source]
def scale_factor : Int32 #

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#scale_factor instead.

[View source]
def subpixel_layout : Gdk::SubpixelLayout #

Gets information about the layout of red, green and blue primaries for pixels.

[View source]
def valid? : Bool #

[View source]
def width_mm : Int32 #

Gets the width in millimeters of the monitor.

[View source]