F:/KPlato/koffice/libs/koproperty/set.h

Aller à la documentation de ce fichier.

/* This file is part of the KDE project
   Copyright (C) 2004 Cedric Pasteur <cedric.pasteur@free.fr>
   Copyright (C) 2004 Alexander Dymo <cloudtemple@mskat.net>
   Copyright (C) 2004-2006 Jaroslaw Staniek <js@iidea.pl>

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

#include "koproperty_global.h"
#include <QObject>
#include <q3asciidict.h>
#include <QByteArray>
#include <QStringList>
#include <QMap>

namespace KoProperty {

class Property;
class SetPrivate;

class KOPROPERTY_EXPORT Set : public QObject
{
        Q_OBJECT

        public:
                class KOPROPERTY_EXPORT Iterator {
                        public:
                                Iterator(const Set &set);
                                ~Iterator();

                                void operator ++();
                                Property*  operator *() const;

                                QByteArray  currentKey() const;
                                Property*  current() const;

                        private:
                                Q3AsciiDictIterator<Property> *iterator;
                                friend class Set;
                };

                explicit Set(QObject *parent=0, const QString &typeName=QString::null);

                explicit Set(const Set& set);

                virtual ~Set();

                void addProperty(Property *property, QByteArray group = "common");

                void removeProperty(Property *property);

                void removeProperty(const QByteArray &name);

                virtual void clear();

                uint count() const;

                bool isEmpty() const;

                bool isReadOnly() const;

                void setReadOnly(bool readOnly);

                bool contains(const QByteArray &name) const;

                Property& property( const QByteArray &name) const;

                Property& operator[](const QByteArray &name) const;

                const Set& operator= (const Set &set);

                void changeProperty(const QByteArray &property, const QVariant &value);

                void setGroupDescription(const QByteArray &group, const QString desc);

                QString groupDescription(const QByteArray &group) const;

                void setGroupIcon(const QByteArray &group, const QString& icon);

                QString groupIcon(const QByteArray &group) const;

                const QList<QByteArray>& groupNames() const;

                const QList<QByteArray>& propertyNamesForGroup(const QByteArray &group) const;

                QByteArray prevSelection() const;

                void setPrevSelection(const QByteArray& prevSelection);

                QString typeName() const;

                void debug();

        protected:
                Set(bool propertyOwner);

                void addToGroup(const QByteArray &group, Property *property);

                void removeFromGroup(Property *property);

                void addPropertyInternal(Property *property, QByteArray group, bool updateSortingKey);

                void informAboutClearing(bool& cleared);

        signals:
                void propertyChanged(KoProperty::Set& set, KoProperty::Property& property);

                void propertyChangedInternal(KoProperty::Set& set, KoProperty::Property& property);

                void propertyReset(KoProperty::Set& set, KoProperty::Property& property);

                void aboutToDeleteProperty(KoProperty::Set& set, KoProperty::Property& property);

                void aboutToBeCleared();

                void aboutToBeDeleted();

        protected:
                SetPrivate *d;

        friend class Iterator;
        friend class Property;
        friend class Buffer;
};

class KOPROPERTY_EXPORT Buffer : public Set
{
        Q_OBJECT

        public:
                Buffer();
                Buffer(const Set *set);

                virtual void intersect(const Set *set);

        protected slots:
                void intersectedChanged(KoProperty::Set& set, KoProperty::Property& prop);
                void intersectedReset(KoProperty::Set& set, KoProperty::Property& prop);

        private:
                void initialSet(const Set *set);
};

}

#endif

---