koffice/lib/kofficecore/KoTemplates.h

/*
   This file is part of the KDE project
   Copyright (C) 2000 Werner Trobin <trobin@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 koTemplates_h
#define koTemplates_h

#include <tqptrlist.h>
#include <tqstringlist.h>
#include <tqpixmap.h>
#include <koffice_export.h>

class KInstance;

/** @internal */
class KOFFICECORE_EXPORT KoTemplate {

public:
    KoTemplate(const TQString &name,
               const TQString &description=TQString(),
               const TQString &file=TQString(),
               const TQString &picture=TQString(),
               const TQString &fileName=TQString(),
               const TQString &_measureSystem=TQString(),
               bool hidden=false, bool touched=false);
    ~KoTemplate() {}

    TQString name() const { return m_name; }
    TQString description() const { return m_descr; };
    TQString file() const { return m_file; }
    TQString picture() const { return m_picture; }
    TQString fileName() const { return m_fileName; }
    const TQPixmap &loadPicture( KInstance* instance );

    bool isHidden() const { return m_hidden; }
    void setHidden(bool hidden=true) { m_hidden=hidden; m_touched=true; }

    bool touched() const { return m_touched; }

    TQString measureSystem() const { return m_measureSystem; }
    void setMeasureSystem(const TQString& system) { m_measureSystem = system; }

private:
    TQString m_name, m_descr, m_file, m_picture, m_fileName;
    bool m_hidden;
    mutable bool m_touched;
    bool m_cached;
    TQPixmap m_pixmap;
    TQString m_measureSystem;
};


class KOFFICECORE_EXPORT KoTemplateGroup {

public:
    KoTemplateGroup(const TQString &name,
                    const TQString &dir=TQString(),
                    int _sortingWeight=0,
                    bool touched=false);
    ~KoTemplateGroup() {}

    TQString name() const { return m_name; }
    TQStringList dirs() const { return m_dirs; }
    void addDir(const TQString &dir) { m_dirs.append(dir); m_touched=true; }
    int sortingWeight() const { return m_sortingWeight; }
    void setSortingWeight(int weight) { m_sortingWeight = weight; }
    /// If all tqchildren are hidden, we are hidden too
    bool isHidden() const;
    /// if we should hide, we hide all the tqchildren
    void setHidden(bool hidden=true) const;

    KoTemplate *first() { return m_templates.first(); }
    KoTemplate *next() { return m_templates.next(); }
    KoTemplate *last() { return m_templates.last(); }
    KoTemplate *prev() { return m_templates.prev(); }
    KoTemplate *current() { return m_templates.current(); }

    bool add(KoTemplate *t, bool force=false, bool touch=true);
    KoTemplate *tqfind(const TQString &name) const;

    bool touched() const { return m_touched; }

private:
    TQString m_name;
    TQStringList m_dirs;
    TQPtrList<KoTemplate> m_templates;
    mutable bool m_touched;
    int m_sortingWeight;
};


class KoTemplateTree {

public:
    KoTemplateTree(const TQCString &templateType, KInstance *instance,
		   bool readTree=false);
    ~KoTemplateTree() {}

    TQCString templateType() const { return m_templateType; }
    KInstance *instance() const { return m_instance; }
    void readTemplateTree();
    void writeTemplateTree();

    KoTemplateGroup *first() { return m_groups.first(); }
    KoTemplateGroup *next() { return m_groups.next(); }
    KoTemplateGroup *last() { return m_groups.last(); }
    KoTemplateGroup *prev() { return m_groups.prev(); }
    KoTemplateGroup *current() { return m_groups.current(); }

    void add(KoTemplateGroup *g);
    KoTemplateGroup *tqfind(const TQString &name) const;

    KoTemplateGroup *defaultGroup() const { return m_defaultGroup; }
    KoTemplate *defaultTemplate() const { return m_defaultTemplate; }

private:
    void readGroups();
    void readTemplates();
    void writeTemplate(KoTemplate *t, KoTemplateGroup *group,
		       const TQString &localDir);

    TQCString m_templateType;
    KInstance *m_instance;
    TQPtrList<KoTemplateGroup> m_groups;
    KoTemplateGroup *m_defaultGroup;
    KoTemplate *m_defaultTemplate;
};


namespace KoTemplates {
TQString stripWhiteSpace(const TQString &string);
}

#endif