---

xmlactionclient.h

// -*- c++ -*-

/*
 *  Copyright (C) 2002-2003, Richard J. Moore <rich@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., 59 Temple Place - Suite 330,
 *  Boston, MA 02111-1307, USA.
 */

#ifndef XMLACTIONCLIENT_H
#define XMLACTIONCLIENT_H

#include <qobject.h>
#include <qxml.h>
#include <qmap.h>

class KActionCollection;
class KAction;

namespace KJSEmbed {

class XMLActionHandler;
class XMLActionRunner;
class XMLActionClient;

class XMLActionScript
{
public:
    bool isValid() const { return !type.isEmpty(); }
    void clear() { src = type = text = QString::null; }

    QString src;
    QString type;
    QString text;
};

class XMLActionRunner
{
public:
    virtual bool run( XMLActionClient *client, const XMLActionScript &script );
};

class XMLActionClient : public QObject
{
    Q_OBJECT

public:

    XMLActionClient( QObject *parent=0, const char *name=0 );
    virtual ~XMLActionClient();

    KActionCollection *actionCollection() const { return ac; }
    void setActionCollection( KActionCollection *acts ) { ac = acts; }

    XMLActionRunner *runner() const { return actrun; }
    void setRunner( XMLActionRunner *r ) { if (actrun) delete actrun; actrun = r; }

    bool load( const QString &filename );

    bool load( XMLActionHandler *handler, const QString &filename );

    bool run( const QString &name );

    XMLActionScript script( const QString &name ) const { return scripts[name]; }

    bool run( const XMLActionScript &script );

    virtual bool bind( const QString &name, const XMLActionScript &script );

    virtual bool bind( KAction *act, const XMLActionScript &script );

protected slots:
    void action_activated();

private:
    KActionCollection *ac;
    XMLActionRunner *actrun;
    QMap<QString, XMLActionScript> scripts;
};

class XMLActionHandler : public QXmlDefaultHandler
{
public:
    XMLActionHandler( XMLActionClient *ac );

    virtual bool startElement( const QString &ns, const QString &ln, const QString &qn,
                               const QXmlAttributes &attrs );
    virtual bool endElement( const QString &ns, const QString &ln, const QString &qn );
    virtual bool characters( const QString &chars );

    void defineAction();

    XMLActionClient *client() const { return ac; }

    virtual KAction *createAction( KActionCollection *parent );

protected:
    struct XMLActionData {
        XMLActionData() { clear(); }

        void clear() {
            text = icons = keys = name = group = whatsthis = status = QString::null;
            exclusive = false;
            script.clear();
        }

        QString type;
        QString text;
        QString icons;
        QString keys;
        QString name;
        QString group;
        bool exclusive;
        QString status;
        QString whatsthis;
        XMLActionScript script;
        QStringList items;
    };

    XMLActionData *actionData() { return &ad; }

private:
    XMLActionClient *ac;
    QString cdata;
    bool inAction;
    XMLActionData ad;
};

}; // namespace KJSEmbed

#endif // XMLACTIONCLIENT_H

---