X Window System Interaction

## X Window System Interaction X Window System Interaction — X backend-specific functions |

## Functions

#define | GDK_ROOT_WINDOW
#define | GDK_DISPLAY
#define | GDK_WINDOW_XDISPLAY()
#define | GDK_WINDOW_XID()
#define | GDK_PIXMAP_XDISPLAY()
#define | GDK_PIXMAP_XID()
#define | GDK_DISPLAY_XDISPLAY()
#define | GDK_DRAWABLE_XDISPLAY()
#define | GDK_DRAWABLE_XID()
#define | GDK_IMAGE_XDISPLAY()
#define | GDK_IMAGE_XIMAGE()
#define | GDK_GC_XDISPLAY()
#define | GDK_COLORMAP_XDISPLAY()
#define | GDK_COLORMAP_XCOLORMAP()
#define | GDK_SCREEN_XDISPLAY()
#define | GDK_SCREEN_XNUMBER()
#define | GDK_SCREEN_XSCREEN()
#define | GDK_VISUAL_XVISUAL()
#define | GDK_FONT_XDISPLAY()
#define | GDK_FONT_XFONT()
#define | GDK_CURSOR_XCURSOR()
#define | GDK_CURSOR_XDISPLAY()
#define | GDK_GC_XGC()
#define | GDK_GC_GET_XGC()
GdkVisual * | gdkx_visual_get ()
GdkColormap * | gdkx_colormap_get ()
gpointer | gdk_xid_table_lookup ()
gpointer | gdk_xid_table_lookup_for_display ()
#define | gdk_font_lookup()
#define | gdk_font_lookup_for_display()
GdkDisplay * | gdk_x11_lookup_xdisplay ()
guint32 | gdk_x11_get_server_time ()
gboolean | gdk_net_wm_supports ()
gboolean | gdk_x11_screen_supports_net_wm_hint ()
const char * | gdk_x11_screen_get_window_manager_name ()
XID | gdk_x11_screen_get_monitor_output ()
GdkVisual * | gdk_x11_screen_lookup_visual ()
void | gdk_x11_window_set_user_time ()
void | gdk_x11_window_move_to_current_desktop ()
guint32 | gdk_x11_display_get_user_time ()
GdkColormap * | gdk_x11_colormap_foreign_new ()
Colormap | gdk_x11_colormap_get_xcolormap ()
Display * | gdk_x11_colormap_get_xdisplay ()
Cursor | gdk_x11_cursor_get_xcursor ()
Display * | gdk_x11_cursor_get_xdisplay ()
void | gdk_x11_display_broadcast_startup_message ()
const gchar * | gdk_x11_display_get_startup_notification_id ()
Display * | gdk_x11_display_get_xdisplay ()
void | gdk_x11_display_grab ()
void | gdk_x11_display_ungrab ()
void | gdk_x11_display_set_cursor_theme ()
void | gdk_x11_register_standard_event_type ()
Display * | gdk_x11_drawable_get_xdisplay ()
XID | gdk_x11_drawable_get_xid ()
const char * | gdk_x11_font_get_name ()
Display * | gdk_x11_font_get_xdisplay ()
gpointer | gdk_x11_font_get_xfont ()
Display * | gdk_x11_gc_get_xdisplay ()
GC | gdk_x11_gc_get_xgc ()
Window | gdk_x11_get_default_root_xwindow ()
gint | gdk_x11_get_default_screen ()
Display * | gdk_x11_get_default_xdisplay ()
void | gdk_x11_grab_server ()
Display * | gdk_x11_image_get_xdisplay ()
XImage * | gdk_x11_image_get_ximage ()
int | gdk_x11_screen_get_screen_number ()
Screen * | gdk_x11_screen_get_xscreen ()
void | gdk_x11_ungrab_server ()
Visual * | gdk_x11_visual_get_xvisual ()
Atom | gdk_x11_atom_to_xatom ()
Atom | gdk_x11_atom_to_xatom_for_display ()
GdkAtom | gdk_x11_xatom_to_atom ()
GdkAtom | gdk_x11_xatom_to_atom_for_display ()
Atom | gdk_x11_get_xatom_by_name ()
Atom | gdk_x11_get_xatom_by_name_for_display ()
const gchar * | gdk_x11_get_xatom_name ()
const gchar * | gdk_x11_get_xatom_name_for_display ()
void | gdk_x11_set_sm_client_id ()
GdkWindow * | gdk_x11_window_foreign_new_for_display ()
GdkWindow * | gdk_x11_window_lookup_for_display ()

## Types and Values

#define | GDK_WINDOW_XWINDOW

## Includes

    #include <gdk/gdkx.h>

## Description

## Functions

### GDK_ROOT_WINDOW

    #define GDK_ROOT_WINDOW()             (gdk_x11_get_default_root_xwindow ())

Obtains the Xlib window id of the root window of the current screen.

### GDK_DISPLAY

    #define GDK_DISPLAY()                 gdk_display

`GDK_DISPLAY` has been deprecated since version 2.22 and should not be used in newly-written code.

Use `gdk_display_get_default()` to get the default GdkDisplay or `gdk_x11_get_default_xdisplay()` to get the corresponding Xlib Display *

The current display.

#### Returns

an Xlib Display*.

### GDK_WINDOW_XDISPLAY()

    #define GDK_WINDOW_XDISPLAY(win)      (GDK_SCREEN_X11 (GDK_WINDOW_SCREEN (win))->xdisplay)

Returns the display of a GdkWindow.

#### Parameters

win | a GdkWindow. |

#### Returns

an Xlib Display*.

### GDK_WINDOW_XID()

    #define GDK_WINDOW_XID(win)           (GDK_DRAWABLE_IMPL_X11(((GdkWindowObject *)win)->impl)->xid)

Returns the X window belonging to a GdkWindow.

#### Parameters

win | a GdkWindow. |

#### Returns

the Xlib Window of `win` .

### GDK_PIXMAP_XDISPLAY()

    #define GDK_PIXMAP_XDISPLAY(pix)      (GDK_SCREEN_X11 (GDK_PIXMAP_SCREEN (pix))->xdisplay)

Returns the display of a GdkPixmap.

#### Parameters

pix | a GdkPixmap. |

#### Returns

an Xlib Display*.

### GDK_PIXMAP_XID()

    #define GDK_PIXMAP_XID(pix)           (GDK_DRAWABLE_IMPL_X11(((GdkPixmapObject *)pix)->impl)->xid)

Returns the X pixmap belonging to a GdkPixmap.

#### Parameters

pix | a GdkPixmap. |

#### Returns

the Xlib XPixmap of `win` .

### GDK_DISPLAY_XDISPLAY()

    #define GDK_DISPLAY_XDISPLAY(display) (GDK_DISPLAY_X11(display)->xdisplay)

Returns the display of a GdkDisplay.

#### Parameters

display | a GdkDisplay. |

### GDK_DRAWABLE_XDISPLAY()

    #define GDK_DRAWABLE_XDISPLAY(win)    (GDK_IS_WINDOW (win) ? GDK_WINDOW_XDISPLAY (win) : GDK_PIXMAP_XDISPLAY (win))

Returns the display of a GdkDrawable.

#### Parameters

win | a GdkDrawable. |

#### Returns

an Xlib Display*.

### GDK_DRAWABLE_XID()

    #define GDK_DRAWABLE_XID(win)         (GDK_IS_WINDOW (win) ? GDK_WINDOW_XID (win) : GDK_PIXMAP_XID (win))

Returns the X resource (window or pixmap) belonging to a GdkDrawable.

#### Parameters

win | a GdkDrawable. |

#### Returns

the ID of `win` 's X resource.

### GDK_IMAGE_XDISPLAY()

    #define GDK_IMAGE_XDISPLAY(image)     (gdk_x11_image_get_xdisplay (image))

Returns the display of a GdkImage.

#### Parameters

image | a GdkImage. |

#### Returns

an Xlib Display*.

### GDK_IMAGE_XIMAGE()

    #define GDK_IMAGE_XIMAGE(image)       (gdk_x11_image_get_ximage (image))

Returns the X image belonging to a GdkImage.

#### Parameters

image | a GdkImage. |

#### Returns

an XImage*.

### GDK_GC_XDISPLAY()

    #define GDK_GC_XDISPLAY(gc)           (GDK_SCREEN_XDISPLAY(GDK_GC_X11(gc)->screen))

Returns the display of a GdkGC.

#### Parameters

gc | a GdkGC. |

#### Returns

an Xlib Display*.

### GDK_COLORMAP_XDISPLAY()

    #define GDK_COLORMAP_XDISPLAY(cmap)   (gdk_x11_colormap_get_xdisplay (cmap))

Returns the display of a GdkColormap.

#### Parameters

cmap | a GdkColormap. |

#### Returns

an Xlib Display*.

### GDK_COLORMAP_XCOLORMAP()

    #define GDK_COLORMAP_XCOLORMAP(cmap)  (gdk_x11_colormap_get_xcolormap (cmap))

Returns the X colormap belonging to a GdkColormap.

#### Parameters

cmap | a GdkColormap. |

#### Returns

an Xlib Colormap.

### GDK_SCREEN_XDISPLAY()

    #define GDK_SCREEN_XDISPLAY(screen)   (GDK_SCREEN_X11 (screen)->xdisplay)

Returns the display of a GdkScreen.

#### Parameters

screen | a GdkScreen. |

#### Returns

an Xlib Display*.

### GDK_SCREEN_XNUMBER()

    #define GDK_SCREEN_XNUMBER(screen)    (GDK_SCREEN_X11 (screen)->screen_num)

Returns the index of a GdkScreen.

#### Parameters

screen | a GdkScreen |

#### Returns

the position of `screen` among the screens of its display.

### GDK_SCREEN_XSCREEN()

    #define GDK_SCREEN_XSCREEN(screen)    (GDK_SCREEN_X11 (screen)->xscreen)

Returns the screen of a GdkScreen.

#### Parameters

screen | a GdkScreen |

#### Returns

an Xlib Screen*.

### GDK_VISUAL_XVISUAL()

    #define GDK_VISUAL_XVISUAL(vis)       (((GdkVisualPrivate *) vis)->xvisual)

Returns the X visual belonging to a GdkVisual.

#### Parameters

vis | a GdkVisual. |

#### Returns

an Xlib Visual*.

### GDK_FONT_XDISPLAY()

    #define GDK_FONT_XDISPLAY(font)       (gdk_x11_font_get_xdisplay (font))

`GDK_FONT_XDISPLAY` is deprecated and should not be used in newly-written code.

Returns the display of a GdkFont.

#### Parameters

font | a GdkFont. |

#### Returns

an Xlib Display*.

### GDK_FONT_XFONT()

    #define GDK_FONT_XFONT(font)          (gdk_x11_font_get_xfont (font))

`GDK_FONT_XFONT` is deprecated and should not be used in newly-written code.

Returns the X font belonging to a GdkFont.

#### Parameters

font | a GdkFont. |

#### Returns

an Xlib XFontStruct* or an XFontSet.

### GDK_CURSOR_XCURSOR()

    #define GDK_CURSOR_XCURSOR(cursor)    (gdk_x11_cursor_get_xcursor (cursor))

Returns the X cursor belonging to a GdkCursor.

#### Parameters

cursor | a GdkCursor. |

#### Returns

an Xlib Cursor.

### GDK_CURSOR_XDISPLAY()

    #define GDK_CURSOR_XDISPLAY(cursor)   (gdk_x11_cursor_get_xdisplay (cursor))

Returns the display of a GdkCursor.

#### Parameters

cursor | a GdkCursor. |

#### Returns

an Xlib Display*.

### GDK_GC_XGC()

    #define GDK_GC_XGC(gc)		      (GDK_GC_X11(gc)->xgc)

Returns the X GC of a GdkGC.

#### Parameters

gc | a GdkGC. |

#### Returns

an Xlib GC.

### GDK_GC_GET_XGC()

    #define GDK_GC_GET_XGC(gc)	      (GDK_GC_X11(gc)->dirty_mask ? _gdk_x11_gc_flush (gc) : ((GdkGCX11 *)(gc))->xgc)

Returns the X GC of a GdkGC.

#### Parameters

gc | a GdkGC. |

#### Returns

an Xlib GC.

### gdkx_visual_get ()

    GdkVisual *
    gdkx_visual_get (VisualID xvisualid);

`gdkx_visual_get` is deprecated and should not be used in newly-written code.

#### Returns

### gdkx_colormap_get ()

    GdkColormap *
    gdkx_colormap_get (Colormap xcolormap);

`gdkx_colormap_get` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_xid_table_lookup ()

    gpointer
    gdk_xid_table_lookup (XID xid);

`gdk_xid_table_lookup` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_xid_table_lookup_for_display ()

    gpointer
    gdk_xid_table_lookup_for_display (GdkDisplay *display,
                                      XID xid);

`gdk_xid_table_lookup_for_display` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_font_lookup()

    #define gdk_font_lookup(xid)	   ((GdkFont*) gdk_xid_table_lookup (xid))

`gdk_font_lookup` is deprecated and should not be used in newly-written code.

Obtains the GdkFont for the given Xlib font ID, or `NULL` if no GdkFont has been created for `xid`.

#### Parameters

xid | an Xlib font ID |

### gdk_font_lookup_for_display()

    #define gdk_font_lookup_for_display(display, xid) ((GdkFont*) gdk_xid_table_lookup_for_display (display, ((xid)|XID_FONT_BIT)))

`gdk_font_lookup_for_display` is deprecated and should not be used in newly-written code.

Obtains the GdkFont for the given Xlib font ID on `display`, or `NULL` if no GdkFont has been created for `xid`.

#### Parameters

display | a GdkDisplay |
xid | an Xlib font ID Since: 2.2 |

### gdk_x11_lookup_xdisplay ()

    GdkDisplay *
    gdk_x11_lookup_xdisplay (Display *xdisplay);

#### Returns

### gdk_x11_get_server_time ()

    guint32
    gdk_x11_get_server_time (GdkWindow *window);

#### Returns

### gdk_net_wm_supports ()

    gboolean
    gdk_net_wm_supports (GdkAtom property);

`gdk_net_wm_supports` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_x11_screen_supports_net_wm_hint ()

    gboolean
    gdk_x11_screen_supports_net_wm_hint (GdkScreen *screen,
                                         GdkAtom property);

#### Returns

### gdk_x11_screen_get_window_manager_name ()

    const char *
    gdk_x11_screen_get_window_manager_name
                                   (GdkScreen *screen);

#### Returns

### gdk_x11_screen_get_monitor_output ()

    XID
    gdk_x11_screen_get_monitor_output (GdkScreen *screen,
                                       gint monitor_num);

#### Returns

### gdk_x11_screen_lookup_visual ()

    GdkVisual *
    gdk_x11_screen_lookup_visual (GdkScreen *screen,
                                  VisualID xvisualid);

#### Returns

### gdk_x11_window_set_user_time ()

    void
    gdk_x11_window_set_user_time (GdkWindow *window,
                                  guint32 timestamp);

### gdk_x11_window_move_to_current_desktop ()

    void
    gdk_x11_window_move_to_current_desktop
                                   (GdkWindow *window);

### gdk_x11_display_get_user_time ()

    guint32
    gdk_x11_display_get_user_time (GdkDisplay *display);

#### Returns

### gdk_x11_colormap_foreign_new ()

    GdkColormap *
    gdk_x11_colormap_foreign_new (GdkVisual *visual,
                                  Colormap xcolormap);

#### Returns

### gdk_x11_colormap_get_xcolormap ()

    Colormap
    gdk_x11_colormap_get_xcolormap (GdkColormap *colormap);

#### Returns

### gdk_x11_colormap_get_xdisplay ()

    Display *
    gdk_x11_colormap_get_xdisplay (GdkColormap *colormap);

#### Returns

### gdk_x11_cursor_get_xcursor ()

    Cursor
    gdk_x11_cursor_get_xcursor (GdkCursor *cursor);

#### Returns

### gdk_x11_cursor_get_xdisplay ()

    Display *
    gdk_x11_cursor_get_xdisplay (GdkCursor *cursor);

#### Returns

### gdk_x11_display_broadcast_startup_message ()

    void
    gdk_x11_display_broadcast_startup_message
                                   (GdkDisplay *display,
                                    const char *message_type,
                                    ...);

### gdk_x11_display_get_startup_notification_id ()

    const gchar *
    gdk_x11_display_get_startup_notification_id
                                   (GdkDisplay *display);

#### Returns

### gdk_x11_display_get_xdisplay ()

    Display *
    gdk_x11_display_get_xdisplay (GdkDisplay *display);

#### Returns

### gdk_x11_display_grab ()

    void
    gdk_x11_display_grab (GdkDisplay *display);

### gdk_x11_display_ungrab ()

    void
    gdk_x11_display_ungrab (GdkDisplay *display);

### gdk_x11_display_set_cursor_theme ()

    void
    gdk_x11_display_set_cursor_theme (GdkDisplay *display,
                                      const gchar *theme,
                                      const gint size);

### gdk_x11_register_standard_event_type ()

    void
    gdk_x11_register_standard_event_type (GdkDisplay *display,
                                          gint event_base,
                                          gint n_events);

### gdk_x11_drawable_get_xdisplay ()

    Display *
    gdk_x11_drawable_get_xdisplay (GdkDrawable *drawable);

#### Returns

### gdk_x11_drawable_get_xid ()

    XID
    gdk_x11_drawable_get_xid (GdkDrawable *drawable);

#### Returns

### gdk_x11_font_get_name ()

    const char *
    gdk_x11_font_get_name (GdkFont *font);

`gdk_x11_font_get_name` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_x11_font_get_xdisplay ()

    Display *
    gdk_x11_font_get_xdisplay (GdkFont *font);

`gdk_x11_font_get_xdisplay` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_x11_font_get_xfont ()

    gpointer
    gdk_x11_font_get_xfont (GdkFont *font);

`gdk_x11_font_get_xfont` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_x11_gc_get_xdisplay ()

    Display *
    gdk_x11_gc_get_xdisplay (GdkGC *gc);

`gdk_x11_gc_get_xdisplay` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_x11_gc_get_xgc ()

    GC
    gdk_x11_gc_get_xgc (GdkGC *gc);

`gdk_x11_gc_get_xgc` is deprecated and should not be used in newly-written code.

#### Returns

### gdk_x11_get_default_root_xwindow ()

    Window
    gdk_x11_get_default_root_xwindow (void);

#### Returns

### gdk_x11_get_default_screen ()

    gint
    gdk_x11_get_default_screen (void);

#### Returns

### gdk_x11_get_default_xdisplay ()

    Display *
    gdk_x11_get_default_xdisplay (void);

#### Returns

### gdk_x11_grab_server ()

    void
    gdk_x11_grab_server (void);

### gdk_x11_image_get_xdisplay ()

    Display *
    gdk_x11_image_get_xdisplay (GdkImage *image);

#### Returns

### gdk_x11_image_get_ximage ()

    XImage *
    gdk_x11_image_get_ximage (GdkImage *image);

#### Returns

### gdk_x11_screen_get_screen_number ()

    int
    gdk_x11_screen_get_screen_number (GdkScreen *screen);

#### Returns

### gdk_x11_screen_get_xscreen ()

    Screen *
    gdk_x11_screen_get_xscreen (GdkScreen *screen);

#### Returns

### gdk_x11_ungrab_server ()

    void
    gdk_x11_ungrab_server (void);

### gdk_x11_visual_get_xvisual ()

    Visual *
    gdk_x11_visual_get_xvisual (GdkVisual *visual);

#### Returns

### gdk_x11_atom_to_xatom ()

    Atom
    gdk_x11_atom_to_xatom (GdkAtom atom);

#### Returns

### gdk_x11_atom_to_xatom_for_display ()

    Atom
    gdk_x11_atom_to_xatom_for_display (GdkDisplay *display,
                                       GdkAtom atom);

#### Returns

### gdk_x11_xatom_to_atom ()

    GdkAtom
    gdk_x11_xatom_to_atom (Atom xatom);

#### Returns

### gdk_x11_xatom_to_atom_for_display ()

    GdkAtom
    gdk_x11_xatom_to_atom_for_display (GdkDisplay *display,
                                       Atom xatom);

#### Returns

### gdk_x11_get_xatom_by_name ()

    Atom
    gdk_x11_get_xatom_by_name (const gchar *atom_name);

#### Returns

### gdk_x11_get_xatom_by_name_for_display ()

    Atom
    gdk_x11_get_xatom_by_name_for_display (GdkDisplay *display,
                                           const gchar *atom_name);

#### Returns

### gdk_x11_get_xatom_name ()

    const gchar *
    gdk_x11_get_xatom_name (Atom xatom);

#### Returns

### gdk_x11_get_xatom_name_for_display ()

    const gchar *
    gdk_x11_get_xatom_name_for_display (GdkDisplay *display,
                                        Atom xatom);

#### Returns

### gdk_x11_set_sm_client_id ()

    void
    gdk_x11_set_sm_client_id (const gchar *sm_client_id);

`gdk_x11_set_sm_client_id` is deprecated and should not be used in newly-written code.

### gdk_x11_window_foreign_new_for_display ()

    GdkWindow *
    gdk_x11_window_foreign_new_for_display
                                   (GdkDisplay *display,
                                    Window window);

#### Returns

### gdk_x11_window_lookup_for_display ()

    GdkWindow *
    gdk_x11_window_lookup_for_display (GdkDisplay *display,
                                       Window window);

#### Returns

## Types and Values

### GDK_WINDOW_XWINDOW

    #define GDK_WINDOW_XWINDOW	      GDK_DRAWABLE_XID

Another name for `GDK_DRAWABLE_XID()`.