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