2 * Copyright (C) 2002 Anders Carlsson <andersca@gnu.org>
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.
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.
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.
21 * This is an implementation of the freedesktop.org "system tray" spec,
22 * http://www.freedesktop.org/wiki/Standards/systemtray-spec
30 #include "gtkprivate.h"
31 #include "gtktrayicon.h"
36 #include <X11/Xatom.h>
38 #define SYSTEM_TRAY_REQUEST_DOCK 0
39 #define SYSTEM_TRAY_BEGIN_MESSAGE 1
40 #define SYSTEM_TRAY_CANCEL_MESSAGE 2
42 #define SYSTEM_TRAY_ORIENTATION_HORZ 0
43 #define SYSTEM_TRAY_ORIENTATION_VERT 1
50 struct _GtkTrayIconPrivate
56 Atom system_tray_opcode_atom;
57 Atom orientation_atom;
58 Window manager_window;
60 GtkOrientation orientation;
63 static void gtk_tray_icon_get_property (GObject *object,
68 static void gtk_tray_icon_realize (GtkWidget *widget);
69 static void gtk_tray_icon_unrealize (GtkWidget *widget);
70 static gboolean gtk_tray_icon_delete (GtkWidget *widget,
72 static gboolean gtk_tray_icon_expose (GtkWidget *widget,
73 GdkEventExpose *event);
75 static void gtk_tray_icon_update_manager_window (GtkTrayIcon *icon);
76 static void gtk_tray_icon_manager_window_destroyed (GtkTrayIcon *icon);
78 G_DEFINE_TYPE (GtkTrayIcon, gtk_tray_icon, GTK_TYPE_PLUG)
81 gtk_tray_icon_class_init (GtkTrayIconClass *class)
83 GObjectClass *gobject_class = (GObjectClass *)class;
84 GtkWidgetClass *widget_class = (GtkWidgetClass *)class;
86 gobject_class->get_property = gtk_tray_icon_get_property;
88 widget_class->realize = gtk_tray_icon_realize;
89 widget_class->unrealize = gtk_tray_icon_unrealize;
90 widget_class->delete_event = gtk_tray_icon_delete;
91 widget_class->expose_event = gtk_tray_icon_expose;
93 g_object_class_install_property (gobject_class,
95 g_param_spec_enum ("orientation",
97 P_("The orientation of the tray"),
99 GTK_ORIENTATION_HORIZONTAL,
100 GTK_PARAM_READABLE));
102 g_type_class_add_private (class, sizeof (GtkTrayIconPrivate));
106 gtk_tray_icon_init (GtkTrayIcon *icon)
108 icon->priv = G_TYPE_INSTANCE_GET_PRIVATE (icon, GTK_TYPE_TRAY_ICON,
111 icon->priv->stamp = 1;
112 icon->priv->orientation = GTK_ORIENTATION_HORIZONTAL;
114 gtk_widget_set_app_paintable (GTK_WIDGET (icon), TRUE);
115 gtk_widget_set_double_buffered (GTK_WIDGET (icon), FALSE);
116 gtk_widget_add_events (GTK_WIDGET (icon), GDK_PROPERTY_CHANGE_MASK);
120 gtk_tray_icon_get_property (GObject *object,
125 GtkTrayIcon *icon = GTK_TRAY_ICON (object);
129 case PROP_ORIENTATION:
130 g_value_set_enum (value, icon->priv->orientation);
133 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
139 gtk_tray_icon_expose (GtkWidget *widget,
140 GdkEventExpose *event)
142 GtkWidget *focus_child;
143 gint border_width, x, y, width, height;
144 gboolean retval = FALSE;
146 gdk_window_clear_area (widget->window, event->area.x, event->area.y,
147 event->area.width, event->area.height);
149 if (GTK_WIDGET_CLASS (gtk_tray_icon_parent_class)->expose_event)
150 retval = GTK_WIDGET_CLASS (gtk_tray_icon_parent_class)->expose_event (widget, event);
152 focus_child = GTK_CONTAINER (widget)->focus_child;
153 if (focus_child && GTK_WIDGET_HAS_FOCUS (focus_child))
155 border_width = GTK_CONTAINER (widget)->border_width;
157 x = widget->allocation.x + border_width;
158 y = widget->allocation.y + border_width;
160 width = widget->allocation.width - 2 * border_width;
161 height = widget->allocation.height - 2 * border_width;
163 gtk_paint_focus (widget->style, widget->window,
164 GTK_WIDGET_STATE (widget),
165 &event->area, widget, "tray_icon",
166 x, y, width, height);
173 gtk_tray_icon_get_orientation_property (GtkTrayIcon *icon)
186 g_assert (icon->priv->manager_window != None);
188 xdisplay = GDK_DISPLAY_XDISPLAY (gtk_widget_get_display (GTK_WIDGET (icon)));
190 gdk_error_trap_push ();
192 result = XGetWindowProperty (xdisplay,
193 icon->priv->manager_window,
194 icon->priv->orientation_atom,
197 &type, &format, &nitems,
198 &bytes_after, &(prop.prop_ch));
199 error = gdk_error_trap_pop ();
201 if (error || result != Success)
204 if (type == XA_CARDINAL)
206 GtkOrientation orientation;
208 orientation = (prop.prop [0] == SYSTEM_TRAY_ORIENTATION_HORZ) ?
209 GTK_ORIENTATION_HORIZONTAL :
210 GTK_ORIENTATION_VERTICAL;
212 if (icon->priv->orientation != orientation)
214 icon->priv->orientation = orientation;
216 g_object_notify (G_OBJECT (icon), "orientation");
224 static GdkFilterReturn
225 gtk_tray_icon_manager_filter (GdkXEvent *xevent,
229 GtkTrayIcon *icon = user_data;
230 XEvent *xev = (XEvent *)xevent;
232 if (xev->xany.type == ClientMessage &&
233 xev->xclient.message_type == icon->priv->manager_atom &&
234 xev->xclient.data.l[1] == icon->priv->selection_atom)
236 GTK_NOTE (PLUGSOCKET,
237 g_print ("GtkStatusIcon %p: tray manager appeared\n", icon));
239 gtk_tray_icon_update_manager_window (icon);
241 else if (xev->xany.window == icon->priv->manager_window)
243 if (xev->xany.type == PropertyNotify &&
244 xev->xproperty.atom == icon->priv->orientation_atom)
246 GTK_NOTE (PLUGSOCKET,
247 g_print ("GtkStatusIcon %p: got PropertyNotify on manager window for orientation atom\n", icon));
249 gtk_tray_icon_get_orientation_property (icon);
251 else if (xev->xany.type == DestroyNotify)
253 GTK_NOTE (PLUGSOCKET,
254 g_print ("GtkStatusIcon %p: got DestroyNotify for manager window\n", icon));
256 gtk_tray_icon_manager_window_destroyed (icon);
259 GTK_NOTE (PLUGSOCKET,
260 g_print ("GtkStatusIcon %p: got other message on manager window\n", icon));
263 return GDK_FILTER_CONTINUE;
267 gtk_tray_icon_unrealize (GtkWidget *widget)
269 GtkTrayIcon *icon = GTK_TRAY_ICON (widget);
270 GdkWindow *root_window;
272 GTK_NOTE (PLUGSOCKET,
273 g_print ("GtkStatusIcon %p: unrealizing\n", icon));
275 if (icon->priv->manager_window != None)
279 gdkwin = gdk_window_lookup_for_display (gtk_widget_get_display (widget),
280 icon->priv->manager_window);
282 gdk_window_remove_filter (gdkwin, gtk_tray_icon_manager_filter, icon);
284 icon->priv->manager_window = None;
287 root_window = gdk_screen_get_root_window (gtk_widget_get_screen (widget));
289 gdk_window_remove_filter (root_window, gtk_tray_icon_manager_filter, icon);
291 GTK_WIDGET_CLASS (gtk_tray_icon_parent_class)->unrealize (widget);
295 gtk_tray_icon_send_manager_message (GtkTrayIcon *icon,
302 XClientMessageEvent ev;
305 memset (&ev, 0, sizeof (ev));
306 ev.type = ClientMessage;
308 ev.message_type = icon->priv->system_tray_opcode_atom;
310 ev.data.l[0] = gdk_x11_get_server_time (GTK_WIDGET (icon)->window);
311 ev.data.l[1] = message;
312 ev.data.l[2] = data1;
313 ev.data.l[3] = data2;
314 ev.data.l[4] = data3;
316 display = GDK_DISPLAY_XDISPLAY (gtk_widget_get_display (GTK_WIDGET (icon)));
318 gdk_error_trap_push ();
320 icon->priv->manager_window, False, NoEventMask, (XEvent *)&ev);
321 XSync (display, False);
322 gdk_error_trap_pop ();
326 gtk_tray_icon_send_dock_request (GtkTrayIcon *icon)
328 GTK_NOTE (PLUGSOCKET,
329 g_print ("GtkStatusIcon %p: sending dock request to manager window %lx\n",
330 icon, (gulong) icon->priv->manager_window));
332 gtk_tray_icon_send_manager_message (icon,
333 SYSTEM_TRAY_REQUEST_DOCK,
334 icon->priv->manager_window,
335 gtk_plug_get_id (GTK_PLUG (icon)),
340 gtk_tray_icon_update_manager_window (GtkTrayIcon *icon)
344 g_return_if_fail (GTK_WIDGET_REALIZED (icon));
346 GTK_NOTE (PLUGSOCKET,
347 g_print ("GtkStatusIcon %p: updating tray icon manager window, current manager window: %lx\n",
348 icon, (gulong) icon->priv->manager_window));
350 if (icon->priv->manager_window != None)
353 GTK_NOTE (PLUGSOCKET,
354 g_print ("GtkStatusIcon %p: trying to find manager window\n", icon));
356 xdisplay = GDK_DISPLAY_XDISPLAY (gtk_widget_get_display (GTK_WIDGET (icon)));
358 XGrabServer (xdisplay);
360 icon->priv->manager_window = XGetSelectionOwner (xdisplay,
361 icon->priv->selection_atom);
363 if (icon->priv->manager_window != None)
364 XSelectInput (xdisplay,
365 icon->priv->manager_window, StructureNotifyMask|PropertyChangeMask);
367 XUngrabServer (xdisplay);
370 if (icon->priv->manager_window != None)
374 GTK_NOTE (PLUGSOCKET,
375 g_print ("GtkStatusIcon %p: is being managed by window %lx\n",
376 icon, (gulong) icon->priv->manager_window));
378 gdkwin = gdk_window_lookup_for_display (gtk_widget_get_display (GTK_WIDGET (icon)),
379 icon->priv->manager_window);
381 gdk_window_add_filter (gdkwin, gtk_tray_icon_manager_filter, icon);
383 gtk_tray_icon_send_dock_request (icon);
385 gtk_tray_icon_get_orientation_property (icon);
388 GTK_NOTE (PLUGSOCKET,
389 g_print ("GtkStatusIcon %p: no tray manager found\n", icon));
393 gtk_tray_icon_manager_window_destroyed (GtkTrayIcon *icon)
395 GtkWidget *widget = GTK_WIDGET (icon);
397 g_return_if_fail (GTK_WIDGET_REALIZED (icon));
398 g_return_if_fail (icon->priv->manager_window != None);
400 GTK_NOTE (PLUGSOCKET,
401 g_print ("GtkStatusIcon %p: tray manager window destroyed\n", icon));
403 gtk_widget_hide (widget);
404 gtk_widget_unrealize (widget);
406 gtk_widget_show (widget);
410 gtk_tray_icon_delete (GtkWidget *widget,
413 GtkTrayIcon *icon = GTK_TRAY_ICON (widget);
415 GTK_NOTE (PLUGSOCKET,
416 g_print ("GtkStatusIcon %p: delete notify, tray manager window %lx\n",
417 icon, (gulong) icon->priv->manager_window));
419 gtk_widget_hide (widget);
420 gtk_widget_unrealize (widget);
422 gtk_widget_show (widget);
428 gtk_tray_icon_realize (GtkWidget *widget)
430 GtkTrayIcon *icon = GTK_TRAY_ICON (widget);
435 GdkWindow *root_window;
437 GTK_WIDGET_CLASS (gtk_tray_icon_parent_class)->realize (widget);
439 GTK_NOTE (PLUGSOCKET,
440 g_print ("GtkStatusIcon %p: realized, window: %lx, socket window: %lx\n",
442 (gulong) GDK_WINDOW_XWINDOW (widget->window),
443 GTK_PLUG (icon)->socket_window ?
444 (gulong) GDK_WINDOW_XWINDOW (GTK_PLUG (icon)->socket_window) : 0UL));
446 screen = gtk_widget_get_screen (widget);
447 display = gdk_screen_get_display (screen);
448 xdisplay = gdk_x11_display_get_xdisplay (display);
450 /* Now see if there's a manager window around */
451 g_snprintf (buffer, sizeof (buffer),
452 "_NET_SYSTEM_TRAY_S%d",
453 gdk_screen_get_number (screen));
455 icon->priv->selection_atom = XInternAtom (xdisplay, buffer, False);
457 icon->priv->manager_atom = XInternAtom (xdisplay, "MANAGER", False);
459 icon->priv->system_tray_opcode_atom = XInternAtom (xdisplay,
460 "_NET_SYSTEM_TRAY_OPCODE",
463 icon->priv->orientation_atom = XInternAtom (xdisplay,
464 "_NET_SYSTEM_TRAY_ORIENTATION",
467 gtk_tray_icon_update_manager_window (icon);
469 root_window = gdk_screen_get_root_window (screen);
471 /* Add a root window filter so that we get changes on MANAGER */
472 gdk_window_add_filter (root_window,
473 gtk_tray_icon_manager_filter, icon);
477 _gtk_tray_icon_send_message (GtkTrayIcon *icon,
479 const gchar *message,
484 g_return_val_if_fail (GTK_IS_TRAY_ICON (icon), 0);
485 g_return_val_if_fail (timeout >= 0, 0);
486 g_return_val_if_fail (message != NULL, 0);
488 if (icon->priv->manager_window == None)
492 len = strlen (message);
494 stamp = icon->priv->stamp++;
496 /* Get ready to send the message */
497 gtk_tray_icon_send_manager_message (icon, SYSTEM_TRAY_BEGIN_MESSAGE,
498 (Window)gtk_plug_get_id (GTK_PLUG (icon)),
499 timeout, len, stamp);
501 /* Now to send the actual message */
502 gdk_error_trap_push ();
505 XClientMessageEvent ev;
508 xdisplay = GDK_DISPLAY_XDISPLAY (gtk_widget_get_display (GTK_WIDGET (icon)));
510 memset (&ev, 0, sizeof (ev));
511 ev.type = ClientMessage;
512 ev.window = (Window)gtk_plug_get_id (GTK_PLUG (icon));
514 ev.message_type = XInternAtom (xdisplay,
515 "_NET_SYSTEM_TRAY_MESSAGE_DATA", False);
518 memcpy (&ev.data, message, 20);
524 memcpy (&ev.data, message, len);
528 XSendEvent (xdisplay,
529 icon->priv->manager_window, False,
530 StructureNotifyMask, (XEvent *)&ev);
531 XSync (xdisplay, False);
534 gdk_error_trap_pop ();
540 _gtk_tray_icon_cancel_message (GtkTrayIcon *icon,
543 g_return_if_fail (GTK_IS_TRAY_ICON (icon));
544 g_return_if_fail (id > 0);
546 gtk_tray_icon_send_manager_message (icon, SYSTEM_TRAY_CANCEL_MESSAGE,
547 (Window)gtk_plug_get_id (GTK_PLUG (icon)),
552 _gtk_tray_icon_new_for_screen (GdkScreen *screen,
555 g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
557 return g_object_new (GTK_TYPE_TRAY_ICON,
564 _gtk_tray_icon_new (const gchar *name)
566 return g_object_new (GTK_TYPE_TRAY_ICON,
572 _gtk_tray_icon_get_orientation (GtkTrayIcon *icon)
574 g_return_val_if_fail (GTK_IS_TRAY_ICON (icon), GTK_ORIENTATION_HORIZONTAL);
576 return icon->priv->orientation;
580 #define __GTK_TRAY_ICON_X11_C__
581 #include "gtkaliasdef.c"