Screen

Object Hierarchy:

Description:

public class Screen : Object

Screen objects are the GDK representation of the screen on which windows can be displayed and on which the pointer moves.

X originally identified screens with physical screens, but nowadays it is more common to have a single Screen which combines several physical monitors (see get_n_monitors).

GdkScreen is used throughout GDK and GTK+ to specify which screen the top level windows are to be displayed on. it is also used to query the screen specification and default settings such as the default visual (gdk_screen_get_system_visual()), the dimensions of the physical monitors (gdk_screen_get_monitor_geometry()), etc.

Namespace: Gdk

Package: gdk-3.0

Content:

Properties:

public void* font_options { set; get; }
public double resolution { set; get; }

Static methods:

public static weak Screen get_default ()
Gets the default screen for the default display.
public static int height ()
Returns the height of the default screen in pixels.
public static int height_mm ()
Returns the height of the default screen in millimeters.
public static int width ()
Returns the width of the default screen in pixels.
public static int width_mm ()
Returns the width of the default screen in millimeters.

Creation methods:

protected Screen ()

Methods:

public Window get_active_window ()
Returns the screen's currently active window.
public weak Display get_display ()
Gets the display to which the screen belongs.
public unowned FontOptions get_font_options ()
Gets any options previously set with set_font_options.
public int get_height ()
Gets the height of screen in pixels
public int get_height_mm ()
Returns the height of screen in millimeters.
public int get_monitor_at_point (int x, int y)
Returns the monitor number in which the point (x,y ) is located.
public int get_monitor_at_window (Window window)
Returns the number of the monitor in which the largest area of the bounding rectangle of window resides.
public void get_monitor_geometry (int monitor_num, out Rectangle dest)
Retrieves the Rectangle representing the size and position of the individual monitor within the entire screen area.
public int get_monitor_height_mm (int monitor_num)
Gets the height in millimeters of the specified monitor.
public string get_monitor_plug_name (int monitor_num)
Returns the output name of the specified monitor.
public int get_monitor_width_mm (int monitor_num)
Gets the width in millimeters of the specified monitor, if available.
public Rectangle get_monitor_workarea (int monitor_num)
Retrieves the Rectangle representing the size and position of the "work area" on a monitor within the entire screen area.
public int get_n_monitors ()
Returns the number of monitors which screen consists of.
public int get_number ()
Gets the index of screen among the screens in the display to which it belongs.
public int get_primary_monitor ()
Gets the primary monitor for screen.
public double get_resolution ()
Gets the resolution for font handling on the screen; see set_resolution for full details.
public weak Visual get_rgba_visual ()
Gets a visual to use for creating windows with an alpha channel.
public weak Window get_root_window ()
Gets the root window of screen.
public bool get_setting (string name, Value value)
Retrieves a desktop-wide setting such as double-click time for the Screen screen.
public weak Visual get_system_visual ()
Get the system's default visual for screen.
public List<weak Window> get_toplevel_windows ()
Obtains a list of all toplevel windows known to GDK on the screen screen.
public int get_width ()
Gets the width of screen in pixels
public int get_width_mm ()
Gets the width of screen in millimeters.
public List<Window>? get_window_stack ()
Returns a List of Windows representing the current window stack.
public bool is_composited ()
Returns whether windows with an RGBA visual can reasonably be expected to have their alpha channel drawn correctly on the screen.
public List<weak Visual> list_visuals ()
Lists the available visuals for the specified screen.
public string make_display_name ()
Determines the name to pass to open to get a Display with this screen as the default screen.
public void set_font_options (FontOptions? options)
Sets the default font options for the screen.
public void set_resolution (double dpi)
Sets the resolution for font handling on the screen.

Signals:

public signal void composited_changed ()
The composited_changed signal is emitted when the composited status of the screen changes
public signal void monitors_changed ()
The monitors_changed signal is emitted when the number, size or position of the monitors attached to the screen change.
public signal void size_changed ()
The size_changed signal is emitted when the pixel width or height of a screen changes.

Inherited Members:

All known members inherited from class GLib.Object