browserrun.h

/* This file is part of the KDE project
 *
 * Copyright (C) 2002 David Faure <faure@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 tdeparts_browserrun_h
#define tdeparts_browserrun_h
 
#include <krun.h>
#include <kservice.h>
#include <tdeparts/browserextension.h>
 
namespace KParts {
 
    class TDEPARTS_EXPORT BrowserRun : public KRun
    {
        TQ_OBJECT
    public:
        BrowserRun( const KURL& url, const KParts::URLArgs& args,
                    KParts::ReadOnlyPart *part, TQWidget *window,
                    bool removeReferrer, bool trustedSource );
 
        // BIC: merge with above constructor
        BrowserRun( const KURL& url, const KParts::URLArgs& args,
                    KParts::ReadOnlyPart *part, TQWidget *window,
                    bool removeReferrer, bool trustedSource, bool hideErrorDialog );
 
        virtual ~BrowserRun();
 
        //KParts::URLArgs urlArgs() const { return m_args; }
        //KParts::ReadOnlyPart* part() const { return m_part; }
 
        KURL url() const { return m_strURL; }
 
        bool hideErrorDialog() const;
 
        TQString suggestedFilename() const { return m_suggestedFilename; }
 
        TQString contentDisposition() const;
 
        bool serverSuggestsSave() const { return contentDisposition() == TQString::fromLatin1("attachment"); }
 
        enum AskSaveResult { Save, Open, Cancel };
        static AskSaveResult askSave( const KURL & url, KService::Ptr offer, const TQString& mimeType, const TQString & suggestedFilename = TQString::null );
 
        enum AskEmbedOrSaveFlags { InlineDisposition = 0, AttachmentDisposition = 1 };
        static AskSaveResult askEmbedOrSave( const KURL & url, const TQString& mimeType, const TQString & suggestedFilename = TQString::null, int flags = 0 );
 
        // virtual so that TDEHTML can implement differently (HTML cache)
        virtual void save( const KURL & url, const TQString & suggestedFilename );
 
        // static so that it can be called from other classes
        static void simpleSave( const KURL & url, const TQString & suggestedFilename,
                                TQWidget* window );
 
        static void simpleSave( const KURL & url, const TQString & suggestedFilename );
 
        static bool allowExecution( const TQString &serviceType, const KURL &url );
 
        static bool isExecutable( const TQString &serviceType );
        static bool isTextExecutable( const TQString &serviceType );
 
    protected:
        virtual void scanFile();
        virtual void init();
        virtual void handleError( TDEIO::Job * job );
 
        enum NonEmbeddableResult { Handled, NotHandled, Delayed };
 
        NonEmbeddableResult handleNonEmbeddable( const TQString& mimeType );
 
    protected slots:
        void slotBrowserScanFinished(TDEIO::Job *job);
        void slotBrowserMimetype(TDEIO::Job *job, const TQString &type);
        void slotCopyToTempFileResult(TDEIO::Job *job);
        virtual void slotStatResult( TDEIO::Job *job );
 
    protected:
        KParts::URLArgs m_args;
        KParts::ReadOnlyPart *m_part; // QGuardedPtr?
        TQGuardedPtr<TQWidget> m_window;
        // Suggested filename given by the server (e.g. HTTP content-disposition)
        // When set, we should really be saving instead of embedding
        TQString m_suggestedFilename;
        TQString m_sMimeType;
        bool m_bRemoveReferrer;
        bool m_bTrustedSource;
    private:
        void redirectToError( int error, const TQString& errorText );
        class BrowserRunPrivate;
        BrowserRunPrivate* d;
 
    };
}
#endif