tdestartupinfo.h

/****************************************************************************
 
 Copyright (C) 2001-2003 Lubos Lunak        <l.lunak@kde.org>
 
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:
 
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
 
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.
 
****************************************************************************/
 
#ifndef __TDESTARTUPINFO_H
#define __TDESTARTUPINFO_H
 
#include <sys/types.h>
#include <tqobject.h>
 
#ifdef TQ_WS_X11 // FIXME(E): Redo in a less X11-specific way
 
#include <tqcstring.h>
#include <tqstring.h>
#include <tqvaluelist.h>
#include "tdelibs_export.h"
 
class TDEStartupInfoId;
class TDEStartupInfoData;
 
class TDEStartupInfoPrivate;
 
class TDECORE_EXPORT TDEStartupInfo
    : public TQObject
    {
    TQ_OBJECT
    
    public:
        static void disableAutoAppStartedSending( bool disable = true );
 
        static void appStarted();
 
        static void appStarted( const TQCString& startup_id );
        
        static void setNewStartupId( TQWidget* window, const TQCString& startup_id );
 
        static void silenceStartup( bool silence );
 
        static TQCString createNewStartupId();
    enum {
        CleanOnCantDetect       = 1 << 0,
        DisableKWinModule       = 1 << 1,
        AnnounceSilenceChanges  = 1 << 2
        };
    
    TDEStartupInfo( int flags, TQObject* parent = NULL, const char* name = NULL );
        TDEStartupInfo( bool clean_on_cantdetect, TQObject* parent = 0, const char* name = 0 );
        virtual ~TDEStartupInfo();
        static bool sendStartup( const TDEStartupInfoId& id, const TDEStartupInfoData& data );
 
        static bool sendStartupX( Display* dpy, const TDEStartupInfoId& id,
            const TDEStartupInfoData& data );
 
        static bool sendChange( const TDEStartupInfoId& id, const TDEStartupInfoData& data );
 
        static bool sendChangeX( Display* dpy, const TDEStartupInfoId& id,
            const TDEStartupInfoData& data );
 
        static bool sendFinish( const TDEStartupInfoId& id );
 
        static bool sendFinishX( Display* dpy, const TDEStartupInfoId& id );
 
        static bool sendFinish( const TDEStartupInfoId& id, const TDEStartupInfoData& data );
 
        static bool sendFinishX( Display* dpy, const TDEStartupInfoId& id,
            const TDEStartupInfoData& data );
 
        static TDEStartupInfoId currentStartupIdEnv();
        static void resetStartupEnv();
        enum startup_t { NoMatch, Match, CantDetect };
        startup_t checkStartup( WId w );
        startup_t checkStartup( WId w, TDEStartupInfoId& id );
        startup_t checkStartup( WId w, TDEStartupInfoData& data );
        startup_t checkStartup( WId w, TDEStartupInfoId& id, TDEStartupInfoData& data );
        void setTimeout( unsigned int secs );
        static void setWindowStartupId( WId window, const TQCString& id );
        static TQCString windowStartupId( WId w );
        static void handleAutoAppStartedSending();
        class Data;
    signals:
        void gotNewStartup( const TDEStartupInfoId& id, const TDEStartupInfoData& data );
        void gotStartupChange( const TDEStartupInfoId& id, const TDEStartupInfoData& data );
        void gotRemoveStartup( const TDEStartupInfoId& id, const TDEStartupInfoData& data );
    protected:
    virtual void customEvent( TQCustomEvent* e_P );
    private slots:
        void startups_cleanup();
        void startups_cleanup_no_age();
        void got_message( const TQString& msg );
        void window_added( WId w );
    void slot_window_added( WId w );
    private:
        void init( int flags );
        friend class TDEStartupInfoPrivate;
        void got_startup_info( const TQString& msg_P, bool update_only_P );
        void got_remove_startup_info( const TQString& msg_P );
        void new_startup_info_internal( const TDEStartupInfoId& id_P,
            Data& data_P, bool update_only_P );
        void remove_startup_info_internal( const TDEStartupInfoId& id_P );
        void remove_startup_pids( const TDEStartupInfoId& id, const TDEStartupInfoData& data );
        void remove_startup_pids( const TDEStartupInfoData& data );
        startup_t check_startup_internal( WId w, TDEStartupInfoId* id, TDEStartupInfoData* data );
        bool find_id( const TQCString& id_P, TDEStartupInfoId* id_O,
            TDEStartupInfoData* data_O );
        bool find_pid( pid_t pid_P, const TQCString& hostname, TDEStartupInfoId* id_O,
            TDEStartupInfoData* data_O );
        bool find_wclass( TQCString res_name_P, TQCString res_class_P,
            TDEStartupInfoId* id_O, TDEStartupInfoData* data_O );
        static TQCString get_window_hostname( WId w_P );
        void startups_cleanup_internal( bool age_P );
        void clean_all_noncompliant();
        static TQString check_required_startup_fields( const TQString& msg,
            const TDEStartupInfoData& data, int screen );
        bool clean_on_cantdetect_; // KDE4 remove unused
        unsigned int timeout;
        TDEStartupInfoPrivate* d;
    };
 
class TDEStartupInfoIdPrivate;
 
class TDECORE_EXPORT TDEStartupInfoId
    {
    public:
        bool operator==( const TDEStartupInfoId& id ) const;
        bool operator!=( const TDEStartupInfoId& id ) const;
        bool none() const;
        void initId( const TQCString& id = "" );
        const TQCString& id() const;
        unsigned long timestamp() const;
        bool setupStartupEnv() const;
        TDEStartupInfoId();
        TDEStartupInfoId( const TDEStartupInfoId& data );
        ~TDEStartupInfoId();
        TDEStartupInfoId& operator=( const TDEStartupInfoId& data );
        bool operator<( const TDEStartupInfoId& id ) const;
    private:
        TDEStartupInfoId( const TQString& txt );
        TQString to_text() const;
        friend class TDEStartupInfo;
        TDEStartupInfoIdPrivate* d;
    };
 
class TDEStartupInfoDataPrivate;
 
class TDECORE_EXPORT TDEStartupInfoData
    {
    public:
        void setBin( const TQString& bin );
        const TQString& bin() const;
        void setName( const TQString& name );
        const TQString& findName() const;
        const TQString& name() const;
        void setDescription( const TQString& descr );
        const TQString& findDescription() const;
        const TQString& description() const;
        void setIcon( const TQString& icon );
        const TQString& findIcon() const;
        const TQString& icon() const;
        void setDesktop( int desktop );
        int desktop() const;
        void setWMClass( const TQCString& wmclass );
        const TQCString findWMClass() const;
        const TQCString& WMClass() const;
        void addPid( pid_t pid );
        const TQValueList< pid_t >& pids() const;
        bool is_pid( pid_t pid ) const;
        void setHostname( const TQCString& hostname = TQCString());
        const TQCString& hostname() const;
    
    enum TriState { Yes, No, Unknown };
    
    void setSilent( TriState state );
    
    TriState silent() const;
        
        void setTimestamp( unsigned long time );
        
        unsigned long timestamp() const;
        
        int screen() const;
        
        void setScreen( int screen );
        
        int xinerama() const;
 
        void setXinerama( int xinerama );
 
        WId launchedBy() const;
        
        void setLaunchedBy( WId window );
 
        void update( const TDEStartupInfoData& data );
 
        TDEStartupInfoData();
 
        TDEStartupInfoData( const TDEStartupInfoData& data );
        ~TDEStartupInfoData();
        TDEStartupInfoData& operator=( const TDEStartupInfoData& data );
    private:
        TDEStartupInfoData( const TQString& txt );
        TQString to_text() const;
        void remove_pid( pid_t pid );
        friend class TDEStartupInfo;
        friend class TDEStartupInfo::Data;
        TDEStartupInfoDataPrivate* d;
    };
 
#endif //TQ_WS_X11
 
#endif