• Skip to content
  • Skip to link menu
Trinity API Reference
  • Trinity API Reference
  • tdeparts
 

tdeparts

  • KParts
  • KParts::BrowserRun
Public Types | Public Member Functions | Static Public Member Functions | Protected Types | Protected Slots | Protected Member Functions | Protected Attributes

KParts::BrowserRun Class Reference

This class extends KRun to provide additional functionality for browsers: More...

#include <browserrun.h>

Inherits KRun.

List of all members.

Public Types

enum  AskSaveResult { Save, Open, Cancel }
enum  AskEmbedOrSaveFlags { InlineDisposition = 0, AttachmentDisposition = 1 }

Public Member Functions

 BrowserRun (const KURL &url, const KParts::URLArgs &args, KParts::ReadOnlyPart *part, TQWidget *window, bool removeReferrer, bool trustedSource)
 BrowserRun (const KURL &url, const KParts::URLArgs &args, KParts::ReadOnlyPart *part, TQWidget *window, bool removeReferrer, bool trustedSource, bool hideErrorDialog)
KURL url () const
bool hideErrorDialog () const
TQString suggestedFilename () const
TQString contentDisposition () const
bool serverSuggestsSave () const
virtual void save (const KURL &url, const TQString &suggestedFilename)

Static Public Member Functions

static AskSaveResult askSave (const KURL &url, KService::Ptr offer, const TQString &mimeType, const TQString &suggestedFilename=TQString::null)
static AskSaveResult askEmbedOrSave (const KURL &url, const TQString &mimeType, const TQString &suggestedFilename=TQString::null, int flags=0)
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 Types

enum  NonEmbeddableResult { Handled, NotHandled, Delayed }

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 Member Functions

virtual void scanFile ()
virtual void init ()
virtual void handleError (TDEIO::Job *job)
NonEmbeddableResult handleNonEmbeddable (const TQString &mimeType)

Protected Attributes

KParts::URLArgs m_args
KParts::ReadOnlyPart * m_part
TQGuardedPtr< TQWidget > m_window
TQString m_suggestedFilename
TQString m_sMimeType
bool m_bRemoveReferrer
bool m_bTrustedSource

Detailed Description

This class extends KRun to provide additional functionality for browsers:

  • "save or open" dialog boxes
  • "save" functionality
  • support for HTTP POST (including saving the result to a temp file if opening a separate application)
  • warning before launching executables off the web
  • custom error handling (i.e. treating errors as HTML pages)
  • generation of SSL metadata depending on the previous URL shown by the part
Author:
David Faure <faure@kde.org>

Definition at line 42 of file browserrun.h.


Member Enumeration Documentation

enum KParts::BrowserRun::NonEmbeddableResult [protected]

NotHandled means that foundMimeType should call KRun::foundMimeType, i.e.

launch an external app.

Definition at line 164 of file browserrun.h.


Constructor & Destructor Documentation

BrowserRun::BrowserRun ( const KURL &  url,
const KParts::URLArgs &  args,
KParts::ReadOnlyPart *  part,
TQWidget *  window,
bool  removeReferrer,
bool  trustedSource 
)
Parameters:
url the URL we're probing
args URL args - includes data for a HTTP POST, etc.
part the part going to open this URL - can be 0L if not created yet
window the mainwindow - passed to TDEIO::Job::setWindow()
removeReferrer if true, the "referrer" metadata from args isn't passed on
trustedSource if false, a warning will be shown before launching an executable Always pass false for trustedSource, except for local directory views.

Definition at line 42 of file browserrun.cpp.

BrowserRun::BrowserRun ( const KURL &  url,
const KParts::URLArgs &  args,
KParts::ReadOnlyPart *  part,
TQWidget *  window,
bool  removeReferrer,
bool  trustedSource,
bool  hideErrorDialog 
)
Parameters:
url the URL we're probing
args URL args - includes data for a HTTP POST, etc.
part the part going to open this URL - can be 0L if not created yet
window the mainwindow - passed to TDEIO::Job::setWindow()
removeReferrer if true, the "referrer" metadata from args isn't passed on
trustedSource if false, a warning will be shown before launching an executable. Always pass false for trustedSource, except for local directory views.
hideErrorDialog if true, no dialog will be shown in case of errors.

Definition at line 54 of file browserrun.cpp.


Member Function Documentation

BrowserRun::AskSaveResult BrowserRun::askEmbedOrSave ( const KURL &  url,
const TQString &  mimeType,
const TQString &  suggestedFilename = TQString::null,
int  flags = 0 
) [static]

Similar to askSave() but for the case where the current application is able to embed the url itself (instead of passing it to another app).

Parameters:
url the URL in question
mimeType the mimetype of the URL
suggestedFilename optional filename suggested by the server
flags set to AttachmentDisposition if suggested by the server
Returns:
Save, Open or Cancel.

Definition at line 323 of file browserrun.cpp.

BrowserRun::AskSaveResult BrowserRun::askSave ( const KURL &  url,
KService::Ptr  offer,
const TQString &  mimeType,
const TQString &  suggestedFilename = TQString::null 
) [static]

Ask the user whether to save or open a url in another application.

Parameters:
url the URL in question
offer the application that will be used to open the URL
mimeType the mimetype of the URL
suggestedFilename optional filename suggested by the server
Returns:
Save, Open or Cancel.

Definition at line 300 of file browserrun.cpp.

TQString BrowserRun::contentDisposition (  )  const
Returns:
Suggested disposition by the server (e.g. HTTP content-disposition)
Since:
3.5.2

Definition at line 521 of file browserrun.cpp.

void BrowserRun::handleError ( TDEIO::Job *  job  )  [protected, virtual]

Called when an error happens.

NOTE: job could be 0L, if you passed hideErrorDialog=true. The default implementation shows a message box, but only when job != 0 .... It is strongly recommended to reimplement this method if you passed hideErrorDialog=true.

Definition at line 444 of file browserrun.cpp.

BrowserRun::NonEmbeddableResult BrowserRun::handleNonEmbeddable ( const TQString &  mimeType  )  [protected]

Helper for foundMimeType: call this if the mimetype couldn't be embedded.

Definition at line 203 of file browserrun.cpp.

bool BrowserRun::hideErrorDialog (  )  const
Returns:
true if no dialog will be shown in case of errors

Definition at line 516 of file browserrun.cpp.

void BrowserRun::init (  )  [protected, virtual]

Reimplemented from KRun.

Definition at line 70 of file browserrun.cpp.

bool BrowserRun::isExecutable ( const TQString &  serviceType  )  [static]

BIC: Obsoleted by KRun::isExecutable( const TQString &serviceType );.

Definition at line 511 of file browserrun.cpp.

void BrowserRun::scanFile (  )  [protected, virtual]

Reimplemented from KRun.

Definition at line 98 of file browserrun.cpp.

void BrowserRun::simpleSave ( const KURL &  url,
const TQString &  suggestedFilename 
) [static]

BIC: Combine with the above function for KDE 4.0.

Definition at line 366 of file browserrun.cpp.

TQString KParts::BrowserRun::suggestedFilename (  )  const [inline]
Returns:
Suggested filename given by the server (e.g. HTTP content-disposition filename)

Definition at line 93 of file browserrun.h.

KURL KParts::BrowserRun::url (  )  const [inline]
Returns:
the URL we're probing

Definition at line 83 of file browserrun.h.


The documentation for this class was generated from the following files:
  • browserrun.h
  • browserrun.cpp

tdeparts

Skip menu "tdeparts"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

tdeparts

Skip menu "tdeparts"
  • arts
  • dcop
  • dnssd
  • interfaces
  •   kspeech
  •     interface
  •     library
  •   tdetexteditor
  • kate
  • kded
  • kdoctools
  • kimgio
  • kjs
  • libtdemid
  • libtdescreensaver
  • tdeabc
  • tdecmshell
  • tdecore
  • tdefx
  • tdehtml
  • tdeinit
  • tdeio
  •   bookmarks
  •   httpfilter
  •   kpasswdserver
  •   kssl
  •   tdefile
  •   tdeio
  •   tdeioexec
  • tdeioslave
  •   http
  • tdemdi
  •   tdemdi
  • tdenewstuff
  • tdeparts
  • tdeprint
  • tderandr
  • tderesources
  • tdespell2
  • tdesu
  • tdeui
  • tdeunittest
  • tdeutils
  • tdewallet
Generated for tdeparts by doxygen 1.7.1
This website is maintained by Timothy Pearson.