kautostart.h

Go to the documentation of this file.

/* This file is part of the KDE libraries
    Copyright (C) 2006 Aaron Seigo <aseigo@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 as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    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 KDELIBS_KAUTOSTART_H
#define KDELIBS_KAUTOSTART_H

#include <kdecore_export.h>

#include <QtCore/QObject>

class QStringList;

class KDECORE_EXPORT KAutostart : public QObject
{
    Q_OBJECT

    public:
        explicit KAutostart(const QString& entryName = QString(),
                            QObject* parent = 0);
        ~KAutostart();

        enum Condition
        {
            NoConditions = 0x0,
            CheckCommand = 0x1,
            CheckCondition = 0x2,
            CheckAll = 0xff
        };
        Q_DECLARE_FLAGS(Conditions, Condition)

        
        enum StartPhase
        {
            BaseDesktop = 0,
            DesktopServices = 1,
            Applications = 2
        };

        void setAutostarts(bool autostart);

        bool autostarts(const QString& environment = QString(),
                        Conditions check = NoConditions) const;

        QString command() const;
        void setCommand(const QString& command);

        QString visibleName() const;
        void setVisibleName(const QString& entryName);

        static bool isServiceRegistered(const QString& entryName);

        QString commandToCheck() const;
        void setCommandToCheck(const QString& exec);

        StartPhase startPhase() const;
        void setStartPhase(StartPhase phase);

        QStringList allowedEnvironments() const;
        void setAllowedEnvironments(const QStringList& environments);
        void addToAllowedEnvironments(const QString& environment);
        void removeFromAllowedEnvironments(const QString& environment);

        QStringList excludedEnvironments() const;
        void setExcludedEnvironments(const QStringList& environments);
        void addToExcludedEnvironments(const QString& environment);
        void removeFromExcludedEnvironments(const QString& environment);

        QString startAfter() const;

        bool checkAllowedEnvironment( const QString& environment ) const;

    private:
        bool checkStartCondition() const;
        class Private;
        Private* const d;
};

Q_DECLARE_OPERATORS_FOR_FLAGS(KAutostart::Conditions)
#endif