added wx-specific code and license info
[wxWidgets.git] / src / gtk / eggtrayicon.c
1 /* -*- Mode: C; tab-width: 8; indent-tabs-mode: t; c-basic-offset: 8 -*- */
2 /* eggtrayicon.c
3 * Copyright (C) 2002 Anders Carlsson <andersca@gnu.org>
4 *
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2 of the License, or (at your option) any later version.
9 *
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
14 *
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the
17 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 * Boston, MA 02111-1307, USA.
19 */
20
21 /*
22
23 Permission to use this file under wxWindows license given by
24 copyright holder:
25 --------
26 From andersca@gnu.org Tue Dec 9 13:01:56 2003
27 Return-path: <andersca@gnu.org>
28 Envelope-to: vasek@localhost
29 Delivery-date: Tue, 09 Dec 2003 13:04:35 +0100
30 Received: from localhost
31 ([127.0.0.1] helo=amavis ident=amavis)
32 by armitage with esmtp (Exim 3.35 #1)
33 id 1ATgbS-0001Gs-00
34 for vasek@localhost; Tue, 09 Dec 2003 13:04:35 +0100
35 Received: from armitage ([127.0.0.1])
36 by amavis (armitage [127.0.0.1]) (amavisd-new, port 10024) with ESMTP
37 id 04227-09 for <vasek@localhost>;
38 Tue, 9 Dec 2003 13:04:11 +0100 (CET)
39 Received: from localhost ([127.0.0.1] ident=fetchmail)
40 by armitage with esmtp (Exim 3.35 #1)
41 id 1ATgb5-0001GY-00
42 for vasek@localhost; Tue, 09 Dec 2003 13:04:11 +0100
43 Delivered-To: alias-email-slavikvaclav@seznam.cz
44 Received: from pop3.seznam.cz [212.80.76.45]
45 by localhost with POP3 (fetchmail-5.9.11)
46 for vasek@localhost (single-drop); Tue, 09 Dec 2003 13:04:11 +0100 (CET)
47 Received: (qmail 9861 invoked from network); 9 Dec 2003 12:02:17 -0000
48 Received: from unknown (HELO maxipes.logix.cz) (81.0.234.97)
49 by buster.go.seznam.cz with SMTP; 9 Dec 2003 12:02:17 -0000
50 Received: by maxipes.logix.cz (Postfix, from userid 604)
51 id 37E6D29A51; Tue, 9 Dec 2003 13:02:16 +0100 (CET)
52 X-Original-To: vaclav.slavik@matfyz.cz
53 Received: from mail.csbnet.se (glutus.csbnet.se [193.11.248.2])
54 by maxipes.logix.cz (Postfix) with ESMTP id 90D6A29A51
55 for <vaclav.slavik@matfyz.cz>; Tue, 9 Dec 2003 13:02:15 +0100 (CET)
56 Received: by mail.csbnet.se (Postfix, from userid 8)
57 id 7AA7F10A6D7; Tue, 9 Dec 2003 13:02:14 +0100 (CET)
58 Received: from carbon.csbnet.se (carbon.csbnet.se [193.11.248.180])
59 by mail.csbnet.se (Postfix) with ESMTP id A190F10A71D
60 for <vaclav.slavik@matfyz.cz>; Tue, 9 Dec 2003 13:01:56 +0100 (CET)
61 Subject: Re: eggtrayicon.{c,h} licensing
62 From: Anders Carlsson <andersca@gnu.org>
63 To: Vaclav Slavik <vaclav.slavik@matfyz.cz>
64 In-Reply-To: <200312091142.54542.vaclav.slavik@matfyz.cz>
65 References: <200312091142.54542.vaclav.slavik@matfyz.cz>
66 Content-Type: text/plain
67 Message-Id: <1070971316.30989.0.camel@carbon.csbnet.se>
68 Mime-Version: 1.0
69 X-Mailer: Ximian Evolution 1.5
70 Date: Tue, 09 Dec 2003 13:01:56 +0100
71 Content-Transfer-Encoding: 7bit
72 X-Scanned-By: CLAM (openantivirus DB) antivirus scanner at mail.csbnet.se
73 X-Virus-Scanned: by amavisd-new-20030616-p5 (Debian) at armitage
74 X-Spam-Status: No, hits=-4.9 tagged_above=-999.0 required=6.3 tests=BAYES_00
75 X-Spam-Level:
76 Status: R
77 X-Status: N
78 X-KMail-EncryptionState:
79 X-KMail-SignatureState:
80
81 On tis, 2003-12-09 at 11:42 +0100, Vaclav Slavik wrote:
82 > Hi,
83 >
84 > I'm working on the wxWindows cross-platform GUI toolkit
85 > (http://www.wxwindows.org) which uses GTK+ and it would save me a lot
86 > of time if I could use your eggtrayicon code to implement tray icons
87 > on X11. Unfortunately I can't use it right now because it is not part
88 > of any library we could depend on (as we do depend on GTK+) and would
89 > have to be included in our sources and it is under the LGPL license.
90 > The problem is that wxWindows' license is more permissive (see
91 > http://www.opensource.org/licenses/wxwindows.php for details) and so
92 > I can't take your code and put it under wxWindows License. And I
93 > can't put code that can't be used under the terms of wxWindows
94 > License into wxWindows either. Do you think it would be possible to
95 > get permission to include eggtrayicon under wxWindows license?
96 >
97 > Thanks,
98 > Vaclav
99 >
100
101 Sure, that's fine by me.
102
103 Anders
104 --------
105 */
106
107 #include "wx/platform.h"
108
109 #ifdef __WXGTK20__
110
111 #include <string.h>
112 #include <gdk/gdkx.h>
113 #include "eggtrayicon.h"
114
115 #define SYSTEM_TRAY_REQUEST_DOCK 0
116 #define SYSTEM_TRAY_BEGIN_MESSAGE 1
117 #define SYSTEM_TRAY_CANCEL_MESSAGE 2
118
119 static GtkPlugClass *parent_class = NULL;
120
121 static void egg_tray_icon_init (EggTrayIcon *icon);
122 static void egg_tray_icon_class_init (EggTrayIconClass *klass);
123
124 static void egg_tray_icon_unrealize (GtkWidget *widget);
125
126 static void egg_tray_icon_update_manager_window (EggTrayIcon *icon);
127
128 GType
129 egg_tray_icon_get_type (void)
130 {
131 static GType our_type = 0;
132
133 if (our_type == 0)
134 {
135 static const GTypeInfo our_info =
136 {
137 sizeof (EggTrayIconClass),
138 (GBaseInitFunc) NULL,
139 (GBaseFinalizeFunc) NULL,
140 (GClassInitFunc) egg_tray_icon_class_init,
141 NULL, /* class_finalize */
142 NULL, /* class_data */
143 sizeof (EggTrayIcon),
144 0, /* n_preallocs */
145 (GInstanceInitFunc) egg_tray_icon_init
146 };
147
148 our_type = g_type_register_static (GTK_TYPE_PLUG, "EggTrayIcon", &our_info, 0);
149 }
150
151 return our_type;
152 }
153
154 static void
155 egg_tray_icon_init (EggTrayIcon *icon)
156 {
157 icon->stamp = 1;
158
159 gtk_widget_add_events (GTK_WIDGET (icon), GDK_PROPERTY_CHANGE_MASK);
160 }
161
162 static void
163 egg_tray_icon_class_init (EggTrayIconClass *klass)
164 {
165 GtkWidgetClass *widget_class = (GtkWidgetClass *)klass;
166
167 parent_class = g_type_class_peek_parent (klass);
168
169 widget_class->unrealize = egg_tray_icon_unrealize;
170 }
171
172 static GdkFilterReturn
173 egg_tray_icon_manager_filter (GdkXEvent *xevent, GdkEvent *event, gpointer user_data)
174 {
175 EggTrayIcon *icon = user_data;
176 XEvent *xev = (XEvent *)xevent;
177
178 if (xev->xany.type == ClientMessage &&
179 xev->xclient.message_type == icon->manager_atom &&
180 xev->xclient.data.l[1] == icon->selection_atom)
181 {
182 egg_tray_icon_update_manager_window (icon);
183 }
184 else if (xev->xany.window == icon->manager_window)
185 {
186 if (xev->xany.type == DestroyNotify)
187 {
188 egg_tray_icon_update_manager_window (icon);
189 }
190 }
191
192 return GDK_FILTER_CONTINUE;
193 }
194
195 static void
196 egg_tray_icon_unrealize (GtkWidget *widget)
197 {
198 EggTrayIcon *icon = EGG_TRAY_ICON (widget);
199 GdkWindow *root_window;
200
201 if (icon->manager_window != None)
202 {
203 GdkWindow *gdkwin;
204
205 gdkwin = gdk_window_lookup_for_display (gtk_widget_get_display (widget),
206 icon->manager_window);
207
208 gdk_window_remove_filter (gdkwin, egg_tray_icon_manager_filter, icon);
209 }
210
211 root_window = gdk_screen_get_root_window (gtk_widget_get_screen (widget));
212
213 gdk_window_remove_filter (root_window, egg_tray_icon_manager_filter, icon);
214
215 if (GTK_WIDGET_CLASS (parent_class)->unrealize)
216 (* GTK_WIDGET_CLASS (parent_class)->unrealize) (widget);
217 }
218
219 static void
220 egg_tray_icon_send_manager_message (EggTrayIcon *icon,
221 long message,
222 Window window,
223 long data1,
224 long data2,
225 long data3)
226 {
227 XClientMessageEvent ev;
228 Display *display;
229
230 ev.type = ClientMessage;
231 ev.window = window;
232 ev.message_type = icon->system_tray_opcode_atom;
233 ev.format = 32;
234 ev.data.l[0] = gdk_x11_get_server_time (GTK_WIDGET (icon)->window);
235 ev.data.l[1] = message;
236 ev.data.l[2] = data1;
237 ev.data.l[3] = data2;
238 ev.data.l[4] = data3;
239
240 display = GDK_DISPLAY_XDISPLAY (gtk_widget_get_display (GTK_WIDGET (icon)));
241
242 gdk_error_trap_push ();
243 XSendEvent (display,
244 icon->manager_window, False, NoEventMask, (XEvent *)&ev);
245 XSync (display, False);
246 gdk_error_trap_pop ();
247 }
248
249 static void
250 egg_tray_icon_send_dock_request (EggTrayIcon *icon)
251 {
252 egg_tray_icon_send_manager_message (icon,
253 SYSTEM_TRAY_REQUEST_DOCK,
254 icon->manager_window,
255 gtk_plug_get_id (GTK_PLUG (icon)),
256 0, 0);
257 }
258
259 static void
260 egg_tray_icon_update_manager_window (EggTrayIcon *icon)
261 {
262 Display *xdisplay;
263
264 xdisplay = GDK_DISPLAY_XDISPLAY (gtk_widget_get_display (GTK_WIDGET (icon)));
265
266 if (icon->manager_window != None)
267 {
268 GdkWindow *gdkwin;
269
270 gdkwin = gdk_window_lookup_for_display (gtk_widget_get_display (GTK_WIDGET (icon)),
271 icon->manager_window);
272
273 gdk_window_remove_filter (gdkwin, egg_tray_icon_manager_filter, icon);
274 }
275
276 XGrabServer (xdisplay);
277
278 icon->manager_window = XGetSelectionOwner (xdisplay,
279 icon->selection_atom);
280
281 if (icon->manager_window != None)
282 XSelectInput (xdisplay,
283 icon->manager_window, StructureNotifyMask);
284
285 XUngrabServer (xdisplay);
286 XFlush (xdisplay);
287
288 if (icon->manager_window != None)
289 {
290 GdkWindow *gdkwin;
291
292 gdkwin = gdk_window_lookup_for_display (gtk_widget_get_display (GTK_WIDGET (icon)),
293 icon->manager_window);
294
295 gdk_window_add_filter (gdkwin, egg_tray_icon_manager_filter, icon);
296
297 /* Send a request that we'd like to dock */
298 egg_tray_icon_send_dock_request (icon);
299 }
300 }
301
302 EggTrayIcon *
303 egg_tray_icon_new_for_xscreen (Screen *xscreen, const char *name)
304 {
305 EggTrayIcon *icon;
306 char buffer[256];
307 GdkWindow *root_window;
308 GdkDisplay *display;
309 GdkScreen *screen;
310
311 g_return_val_if_fail (xscreen != NULL, NULL);
312
313 icon = g_object_new (EGG_TYPE_TRAY_ICON, NULL);
314 gtk_window_set_title (GTK_WINDOW (icon), name);
315
316 display = gdk_x11_lookup_xdisplay (DisplayOfScreen (xscreen));
317 screen = gdk_display_get_screen (display, XScreenNumberOfScreen (xscreen));
318
319 gtk_plug_construct_for_display (GTK_PLUG (icon),
320 display, 0);
321
322 gtk_window_set_screen (GTK_WINDOW (icon), screen);
323
324 gtk_widget_realize (GTK_WIDGET (icon));
325
326 /* Now see if there's a manager window around */
327 g_snprintf (buffer, sizeof (buffer),
328 "_NET_SYSTEM_TRAY_S%d",
329 XScreenNumberOfScreen (xscreen));
330
331 icon->selection_atom = XInternAtom (DisplayOfScreen (xscreen),
332 buffer, False);
333
334 icon->manager_atom = XInternAtom (DisplayOfScreen (xscreen),
335 "MANAGER", False);
336
337 icon->system_tray_opcode_atom = XInternAtom (DisplayOfScreen (xscreen),
338 "_NET_SYSTEM_TRAY_OPCODE", False);
339
340 egg_tray_icon_update_manager_window (icon);
341
342 root_window = gdk_screen_get_root_window (gtk_widget_get_screen (GTK_WIDGET (icon)));
343
344 /* Add a root window filter so that we get changes on MANAGER */
345 gdk_window_add_filter (root_window,
346 egg_tray_icon_manager_filter, icon);
347
348 return icon;
349 }
350
351 EggTrayIcon *
352 egg_tray_icon_new_for_screen (GdkScreen *screen, const char *name)
353 {
354 g_return_val_if_fail (GDK_IS_SCREEN (screen), NULL);
355
356 return egg_tray_icon_new_for_xscreen (GDK_SCREEN_XSCREEN (screen), name);
357 }
358
359 EggTrayIcon*
360 egg_tray_icon_new (const gchar *name)
361 {
362 return egg_tray_icon_new_for_xscreen (DefaultScreenOfDisplay (gdk_display), name);
363 }
364
365 guint
366 egg_tray_icon_send_message (EggTrayIcon *icon,
367 gint timeout,
368 const gchar *message,
369 gint len)
370 {
371 guint stamp;
372
373 g_return_val_if_fail (EGG_IS_TRAY_ICON (icon), 0);
374 g_return_val_if_fail (timeout >= 0, 0);
375 g_return_val_if_fail (message != NULL, 0);
376
377 if (icon->manager_window == None)
378 return 0;
379
380 if (len < 0)
381 len = strlen (message);
382
383 stamp = icon->stamp++;
384
385 /* Get ready to send the message */
386 egg_tray_icon_send_manager_message (icon, SYSTEM_TRAY_BEGIN_MESSAGE,
387 (Window)gtk_plug_get_id (GTK_PLUG (icon)),
388 timeout, len, stamp);
389
390 /* Now to send the actual message */
391 gdk_error_trap_push ();
392 while (len > 0)
393 {
394 XClientMessageEvent ev;
395 Display *xdisplay;
396
397 xdisplay = GDK_DISPLAY_XDISPLAY (gtk_widget_get_display (GTK_WIDGET (icon)));
398
399 ev.type = ClientMessage;
400 ev.window = (Window)gtk_plug_get_id (GTK_PLUG (icon));
401 ev.format = 8;
402 ev.message_type = XInternAtom (xdisplay,
403 "_NET_SYSTEM_TRAY_MESSAGE_DATA", False);
404 if (len > 20)
405 {
406 memcpy (&ev.data, message, 20);
407 len -= 20;
408 message += 20;
409 }
410 else
411 {
412 memcpy (&ev.data, message, len);
413 len = 0;
414 }
415
416 XSendEvent (xdisplay,
417 icon->manager_window, False, StructureNotifyMask, (XEvent *)&ev);
418 XSync (xdisplay, False);
419 }
420 gdk_error_trap_pop ();
421
422 return stamp;
423 }
424
425 void
426 egg_tray_icon_cancel_message (EggTrayIcon *icon,
427 guint id)
428 {
429 g_return_if_fail (EGG_IS_TRAY_ICON (icon));
430 g_return_if_fail (id > 0);
431
432 egg_tray_icon_send_manager_message (icon, SYSTEM_TRAY_CANCEL_MESSAGE,
433 (Window)gtk_plug_get_id (GTK_PLUG (icon)),
434 id, 0, 0);
435 }
436
437 #endif /* __WXGTK20__ */