Pileus Git - ~andy/gtk/blob - gdk/gdkdisplaymanager.c

   1 /* GDK - The GIMP Drawing Kit
   2  * Copyright (C) 2000 Red Hat, Inc.
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /*
  21  * Modified by the GTK+ Team and others 1997-2000.  See the AUTHORS
  22  * file for a list of people on the GTK+ Team.  See the ChangeLog
  23  * files for a list of changes.  These files are distributed with
  24  * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
  25  */
  26
  27 #include "config.h"
  28
  29 #include "gdkconfig.h"
  30 #include "gdkdisplaymanager.h"
  31
  32 #include "gdkscreen.h"
  33 #include "gdkdisplay.h"
  34 #include "gdkinternals.h"
  35 #include "gdkmarshalers.h"
  36 #include "gdkintl.h"
  37
  38
  39 /**
  40  * SECTION:gdkdisplaymanager
  41  * @Short_description: Maintains a list of all open GdkDisplays
  42  * @Title: GdkDisplayManager
  43  *
  44  * The purpose of the #GdkDisplayManager singleton object is to offer
  45  * notification when displays appear or disappear or the default display
  46  * changes.
  47  */
  48
  49
  50 enum {
  51   PROP_0,
  52   PROP_DEFAULT_DISPLAY
  53 };
  54
  55 enum {
  56   DISPLAY_OPENED,
  57   LAST_SIGNAL
  58 };
  59
  60 static void gdk_display_manager_class_init   (GdkDisplayManagerClass *klass);
  61 static void gdk_display_manager_set_property (GObject                *object,
  62                                               guint                   prop_id,
  63                                               const GValue           *value,
  64                                               GParamSpec             *pspec);
  65 static void gdk_display_manager_get_property (GObject                *object,
  66                                               guint                   prop_id,
  67                                               GValue                 *value,
  68                                               GParamSpec             *pspec);
  69
  70 static guint signals[LAST_SIGNAL] = { 0 };
  71
  72 G_DEFINE_TYPE (GdkDisplayManager, gdk_display_manager, G_TYPE_OBJECT)
  73
  74 static void
  75 gdk_display_manager_class_init (GdkDisplayManagerClass *klass)
  76 {
  77   GObjectClass *object_class = G_OBJECT_CLASS (klass);
  78
  79   object_class->set_property = gdk_display_manager_set_property;
  80   object_class->get_property = gdk_display_manager_get_property;
  81
  82   /**
  83    * GdkDisplayManager::display-opened:
  84    * @manager: the object on which the signal is emitted
  85    * @display: the opened display
  86    *
  87    * The ::display-opened signal is emitted when a display is opened.
  88    *
  89    * Since: 2.2
  90    */
  91   signals[DISPLAY_OPENED] =
  92     g_signal_new (g_intern_static_string ("display-opened"),
  93                   G_OBJECT_CLASS_TYPE (object_class),
  94                   G_SIGNAL_RUN_LAST,
  95                   G_STRUCT_OFFSET (GdkDisplayManagerClass, display_opened),
  96                   NULL, NULL,
  97                   _gdk_marshal_VOID__OBJECT,
  98                   G_TYPE_NONE,
  99                   1,
 100                   GDK_TYPE_DISPLAY);
 101
 102   g_object_class_install_property (object_class,
 103                                    PROP_DEFAULT_DISPLAY,
 104                                    g_param_spec_object ("default-display",
 105                                                         P_("Default Display"),
 106                                                         P_("The default display for GDK"),
 107                                                         GDK_TYPE_DISPLAY,
 108                                                         G_PARAM_READWRITE|G_PARAM_STATIC_NAME|
 109                                                         G_PARAM_STATIC_NICK|G_PARAM_STATIC_BLURB));
 110 }
 111
 112 static void
 113 gdk_display_manager_init (GdkDisplayManager *manager)
 114 {
 115 }
 116
 117 static void
 118 gdk_display_manager_set_property (GObject      *object,
 119                                   guint         prop_id,
 120                                   const GValue *value,
 121                                   GParamSpec   *pspec)
 122 {
 123   switch (prop_id)
 124     {
 125     case PROP_DEFAULT_DISPLAY:
 126       gdk_display_manager_set_default_display (GDK_DISPLAY_MANAGER (object),
 127                                                g_value_get_object (value));
 128       break;
 129     default:
 130       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 131       break;
 132     }
 133 }
 134
 135 static void
 136 gdk_display_manager_get_property (GObject      *object,
 137                                   guint         prop_id,
 138                                   GValue       *value,
 139                                   GParamSpec   *pspec)
 140 {
 141   switch (prop_id)
 142     {
 143     case PROP_DEFAULT_DISPLAY:
 144       g_value_set_object (value,
 145                           gdk_display_manager_get_default_display (GDK_DISPLAY_MANAGER (object)));
 146       break;
 147     default:
 148       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 149       break;
 150     }
 151 }
 152
 153 #ifdef GDK_WINDOWING_X11
 154 extern GType gdk_display_manager_x11_get_type (void);
 155 #endif
 156
 157 /**
 158  * gdk_display_manager_get:
 159  *
 160  * Gets the singleton #GdkDisplayManager object.
 161  *
 162  * Returns: (transfer none): The global #GdkDisplayManager singleton;
 163  *     gdk_parse_pargs(), gdk_init(), or gdk_init_check() must have
 164  *     been called first.
 165  *
 166  * Since: 2.2
 167  **/
 168 GdkDisplayManager*
 169 gdk_display_manager_get (void)
 170 {
 171   static GdkDisplayManager *manager = NULL;
 172
 173   if (!manager)
 174     {
 175       const gchar *backend;
 176
 177       backend = g_getenv ("GDK_BACKEND");
 178 #ifdef GDK_WINDOWING_X11
 179       if (backend == NULL || strcmp (backend, "x11") == 0)
 180         manager = g_object_new (gdk_display_manager_x11_get_type (), NULL);
 181       else
 182 #endif
 183       if (backend != NULL)
 184         g_error ("Unsupported GDK backend: %s", backend);
 185       else
 186         g_error ("No GDK backend found");
 187     }
 188
 189   return manager;
 190 }
 191
 192 /**
 193  * gdk_display_manager_get_default_display:
 194  * @manager: a #GdkDisplayManager
 195  *
 196  * Gets the default #GdkDisplay.
 197  *
 198  * Returns: (transfer none): a #GdkDisplay, or %NULL
 199  *     if there is no default display.
 200  *
 201  * Since: 2.2
 202  */
 203 GdkDisplay *
 204 gdk_display_manager_get_default_display (GdkDisplayManager *manager)
 205 {
 206   return GDK_DISPLAY_MANAGER_GET_CLASS (manager)->get_default_display (manager);
 207 }
 208
 209 /**
 210  * gdk_display_get_default:
 211  *
 212  * Gets the default #GdkDisplay. This is a convenience
 213  * function for
 214  * <literal>gdk_display_manager_get_default_display (gdk_display_manager_get ())</literal>.
 215  *
 216  * Returns: (transfer none): a #GdkDisplay, or %NULL if there is no default
 217  *   display.
 218  *
 219  * Since: 2.2
 220  */
 221 GdkDisplay *
 222 gdk_display_get_default (void)
 223 {
 224   return gdk_display_manager_get_default_display (gdk_display_manager_get ());
 225 }
 226
 227 /**
 228  * gdk_screen_get_default:
 229  *
 230  * Gets the default screen for the default display. (See
 231  * gdk_display_get_default ()).
 232  *
 233  * Returns: (transfer none): a #GdkScreen, or %NULL if there is no default display.
 234  *
 235  * Since: 2.2
 236  */
 237 GdkScreen *
 238 gdk_screen_get_default (void)
 239 {
 240   GdkDisplay *default_display;
 241
 242   default_display = gdk_display_get_default ();
 243
 244   if (default_display)
 245     return gdk_display_get_default_screen (default_display);
 246   else
 247     return NULL;
 248 }
 249
 250 /**
 251  * gdk_display_manager_set_default_display:
 252  * @manager: a #GdkDisplayManager
 253  * @display: a #GdkDisplay
 254  *
 255  * Sets @display as the default display.
 256  *
 257  * Since: 2.2
 258  **/
 259 void
 260 gdk_display_manager_set_default_display (GdkDisplayManager *manager,
 261                                          GdkDisplay        *display)
 262 {
 263   GDK_DISPLAY_MANAGER_GET_CLASS (manager)->set_default_display (manager, display);
 264
 265   g_object_notify (G_OBJECT (manager), "default-display");
 266 }
 267
 268 /**
 269  * gdk_display_manager_list_displays:
 270  * @manager: a #GdkDisplayManager
 271  *
 272  * List all currently open displays.
 273  *
 274  * Return value: (transfer container) (element-type GdkDisplay): a newly
 275  *     allocated #GSList of #GdkDisplay objects. Free with g_slist_free()
 276  *     when you are done with it.
 277  *
 278  * Since: 2.2
 279  **/
 280 GSList *
 281 gdk_display_manager_list_displays (GdkDisplayManager *manager)
 282 {
 283   return GDK_DISPLAY_MANAGER_GET_CLASS (manager)->list_displays (manager);
 284 }
 285
 286 GdkDisplay *
 287 gdk_display_manager_open_display (GdkDisplayManager *manager,
 288                                   const gchar       *name)
 289 {
 290   return GDK_DISPLAY_MANAGER_GET_CLASS (manager)->open_display (manager, name);
 291 }