~ubuntu-branches/ubuntu/saucy/kde-runtime/saucy-proposed

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
/*
   Copyright (C) 2010 by Sjors Gielen <dazjorz@dazjorz.com>

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2, or (at your option)
   any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.

 */

#ifndef NOTIFYBYPOPUPGROWL_H
#define NOTIFYBYPOPUPGROWL_H

#include <QPixmap>
#include <QString>

/**
 * @brief Display a notification using Growl.
 *
 * Currently, this class uses QSystemTrayIcon to actually display the
 * notification. Inside the Growl project, a protocol is being developed
 * to display notifications; this protocol is currently only implemented
 * (partly) in the Windows version of Growl. Once it is finished, it will be
 * implemented in KNotify and used instead.
 * (The normal Growl API is written in Objective C. It's possible to use it,
 * but it's a lot harder than just waiting for GNTP to stabilize.)
 */
class NotifyByPopupGrowl
{
public:
    static bool canPopup();
    static QStringList capabilities();
    static void popup( const QPixmap *icon, int timeout,
                       const QString &title, const QString &message );
};

#endif // NOTIFYBYPOPUPGROWL_H