Next: , Up: Gdk Reference

5.1 Screens and displays

Multihead support is based around two main object types:

display objects are the GDK representation of the X Display which can be described as a workstation consisting of a keyboard a pointing device (such as a mouse) and one or more screens. It is used to open and keep track of various GdkScreen objects currently instanciated by the application. It is also used to grab and release the keyboard and the mouse pointer.

screen objects are the GDK representation of a physical screen. It 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 colormap (screen-default-colormap), the screen width (screen-width), etc.

The following code samples demonstrate common usage of the objects described above.

Testing the number of screen on the current display:

     (use-package :gdk)
     (defvar *display* (default-display))
     (display-name *display*) => ":0.0"
     (display-n-screens *display*) => 1

Opening a second display: (TODO)

     /* screen2_name needs to be initialized before calling
     /* gdk_display_new() */
     second_display = gdk_display_new (&argc, &argv, second_screen_name);
     if (second_display)
         second_screen = gdk_display_get_default_screen (second_display);
     	g_print ("Can't open display :\n\t%s\n\n",
         exit (1);
     /* now GdkScreen can be assigned to GtkWindows */
     window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
     gtk_window_set_screen (window, second_screen);