F:/KPlato/koffice/libs/kofficecore/KoFilter.h

Aller à la documentation de ce fichier.

/* This file is part of the KOffice libraries
   Copyright (C) 2001 Werner Trobin <trobin@kde.org>
                 2002 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 version 2 as published by the Free Software Foundation.

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

#include <QObject>
#include <QMap>
#include <q3ptrstack.h>
#include <koffice_export.h>
class QIODevice;
class KoFilterChain;

class KOFFICECORE_EXPORT KoFilter : public QObject
{
    Q_OBJECT

    friend class KoFilterEntry;  // needed for the filter chain pointer :(
    friend class KoFilterChain;

public:
    enum ConversionStatus { OK, StupidError, UsageError, CreationError, FileNotFound,
                            StorageCreationError, BadMimeType, BadConversionGraph,
                            EmbeddedDocError, WrongFormat, NotImplemented,
                            ParsingError, InternalError, UnexpectedEOF,
                            UnexpectedOpcode, UserCancelled, OutOfMemory,
                            PasswordProtected,
                            JustInCaseSomeBrokenCompilerUsesLessThanAByte = 255 };

    virtual ~KoFilter();

    virtual ConversionStatus convert( const QByteArray& from, const QByteArray& to ) = 0;

signals:
    void sigProgress( int value );

protected:
    KoFilter( QObject* parent = 0 );

    KoFilterChain* m_chain;

private:
    KoFilter( const KoFilter& rhs );
    KoFilter& operator=( const KoFilter& rhs );

    class Private;
    Private* d;
};


class KOFFICECORE_EXPORT KoEmbeddingFilter : public KoFilter
{
    Q_OBJECT

    friend class KoFilterChain;

public:
    virtual ~KoEmbeddingFilter();

    int lruPartIndex() const;

    static QString mimeTypeByExtension( const QString& extension );

protected:
    KoEmbeddingFilter();

    int embedPart( const QByteArray& from, QByteArray& to,
                   KoFilter::ConversionStatus& status,
                   const QString& key = QString::null );

    void startInternalEmbedding( const QString& key, const QByteArray& mimeType );

    void endInternalEmbedding();

    int internalPartReference( const QString& key ) const;

    QByteArray internalPartMimeType( const QString& key ) const;

private:
    struct PartReference
    {
        PartReference( int index = -1, const QByteArray& mimeType = "" );
        bool isValid() const;

        int m_index;
        QByteArray m_mimeType;
    };

    struct PartState
    {
        PartState();

        int m_lruPartIndex;
        QMap<QString, PartReference> m_partReferences;
    };

    KoEmbeddingFilter( const KoEmbeddingFilter& rhs );
    KoEmbeddingFilter& operator=( const KoEmbeddingFilter& rhs );

    virtual void savePartContents( QIODevice* file );

    void filterChainEnterDirectory( const QString& directory ) const;
    void filterChainLeaveDirectory() const;

    Q3PtrStack<PartState> m_partStack;

    class Private;
    Private* d;
};

#endif

---