## 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