GdkDisplayManager

GdkDisplayManager — Maintains a list of all open GdkDisplays

Synopsis


#include <gdk/gdk.h>


                    GdkDisplayManager;
GdkDisplayManager*  gdk_display_manager_get             (void);
GdkDisplay*         gdk_display_manager_get_default_display
                                                        (GdkDisplayManager *display_manager);
void                gdk_display_manager_set_default_display
                                                        (GdkDisplayManager *display_manager,
                                                         GdkDisplay *display);
GSList*             gdk_display_manager_list_displays   (GdkDisplayManager *display_manager);
GdkDevice*          gdk_display_get_core_pointer        (GdkDisplay *display);

Object Hierarchy


  GObject
   +----GdkDisplayManager

Properties


  "default-display"          GdkDisplay            : Read / Write

Signals


  "display-opened"                                 : Run Last

Description

The purpose of the GdkDisplayManager singleton object is to offer notification when displays appear or disappear or the default display changes.

Details

GdkDisplayManager

typedef struct _GdkDisplayManager GdkDisplayManager;

The GdkDisplayManager struct has no interesting fields.

Since 2.2


gdk_display_manager_get ()

GdkDisplayManager*  gdk_display_manager_get             (void);

Returns the global GdkDisplayManager singleton; gdk_parse_pargs(), gdk_init(), or gdk_init_check() must have been called first.

Returns : the singleton GdkDisplayManager object.

Since 2.2


gdk_display_manager_get_default_display ()

GdkDisplay*         gdk_display_manager_get_default_display
                                                        (GdkDisplayManager *display_manager);

Gets the default GdkDisplay.

display_manager : a GdkDisplayManager
Returns : a GdkDisplay, or NULL if there is no default display.

Since 2.2


gdk_display_manager_set_default_display ()

void                gdk_display_manager_set_default_display
                                                        (GdkDisplayManager *display_manager,
                                                         GdkDisplay *display);

Sets display as the default display.

display_manager : a GdkDisplayManager
display : a GdkDisplay

Since 2.2


gdk_display_manager_list_displays ()

GSList*             gdk_display_manager_list_displays   (GdkDisplayManager *display_manager);

List all currently open displays.

display_manager : a GdkDisplayManager
Returns : a newly allocated GSList of GdkDisplay objects. Free this list with g_slist_free() when you are done with it.

Since 2.2


gdk_display_get_core_pointer ()

GdkDevice*          gdk_display_get_core_pointer        (GdkDisplay *display);

Returns the core pointer device for the given display

display : a GdkDisplay
Returns : the core pointer device; this is owned by the display and should not be freed.

Since 2.2

Property Details

The "default-display" property

  "default-display"          GdkDisplay            : Read / Write

The default display for GDK.

Signal Details

The "display-opened" signal

void                user_function                      (GdkDisplayManager *display_manager,
                                                        GdkDisplay        *display,
                                                        gpointer           user_data)            : Run Last

The ::display_opened signal is emitted when a display is opened.

display_manager : the object on which the signal is emitted
display : the opened display
user_data : user data set when the signal handler was connected.

Since 2.2