knotifyclient.h

/* This file is part of the KDE libraries
   Copyright (C) 2000 Charles Samuels <charles@kde.org>
 
   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Library General Public
   License version 2 as published by the Free Software Foundation.
 
   This library 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
   Library General Public License for more details.
 
   You should have received a copy of the GNU Library General Public License
   along with this library; see the file COPYING.LIB.  If not, write to
   the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/
#ifndef _KNOTIFY_CLIENT
#define _KNOTIFY_CLIENT
#include <tqstring.h>
#include "tdelibs_export.h"
 
class TDEInstance;
#undef None // X11 headers...

 
 
namespace KNotifyClient
{
    struct InstancePrivate;
    class InstanceStack;

    class TDECORE_EXPORT Instance
    {
    public:
        Instance(TDEInstance *instance);
        ~Instance();
    bool useSystemBell() const;
        static TDEInstance *current();

    static Instance *currentInstance();
    
    private:
        static InstanceStack *instances();
        InstancePrivate *d;
        static InstanceStack *s_instances;
    };
 

    enum {
        Default = -1,
        None = 0,
        Sound = 1,
        Messagebox = 2,
        Logfile = 4,
        Stderr = 8,
        PassivePopup = 16, 
        Execute = 32,      
        Taskbar = 64       
    };

    enum {
        Notification=1,
        Warning=2,
        Error=4,
        Catastrophe=8
    };

    enum StandardEvent {
        cannotOpenFile,
        notification,
        warning,
        fatalError,
        catastrophe
    };

    TDECORE_EXPORT bool startDaemon();
 
//#ifndef KDE_NO_COMPAT
    TDECORE_EXPORT int event(const TQString &message, const TQString &text=TQString::null) TDE_DEPRECATED;

    TDECORE_EXPORT int event( StandardEvent event, const TQString& text=TQString::null ) TDE_DEPRECATED;

    TDECORE_EXPORT int userEvent(const TQString &text=TQString::null, int present=Default, int level=Default,
                                 const TQString &sound=TQString::null, const TQString &file=TQString::null) TDE_DEPRECATED;
    
//#endif

    // KDE4: use WId instead of int
    TDECORE_EXPORT int event( int winId, const TQString& message,
                              const TQString& text = TQString::null );

    // KDE4: use WId instead of int
    TDECORE_EXPORT int event( int winId, StandardEvent event,
                              const TQString& text = TQString::null );

    // KDE4: use WId instead of int
    TDECORE_EXPORT int userEvent(int winId, const TQString &text=TQString::null, int present=Default, int level=Default,
                          const TQString &sound=TQString::null, const TQString &file=TQString::null);
    
    TDECORE_EXPORT void beep(const TQString& reason=TQString::null);

    TDECORE_EXPORT int getPresentation(const TQString &eventname);
    
    TDECORE_EXPORT TQString getFile(const TQString &eventname, int present);
    
    TDECORE_EXPORT int getDefaultPresentation(const TQString &eventname);
    
    TDECORE_EXPORT TQString getDefaultFile(const TQString &eventname, int present);

    TDECORE_EXPORT TDEInstance * instance();
}
 
#endif