KParts
KParts::BrowserRun Class Reference
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.
#include <browserrun.h>

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
Definition at line 39 of file browserrun.h.
Member Enumeration Documentation
Definition at line 88 of file browserrun.h.
Definition at line 77 of file browserrun.h.
enum KParts::BrowserRun::NonEmbeddableResult [protected] |
NotHandled means that foundMimeType should call KRun::foundMimeType, i.e.
launch an external app.
Definition at line 134 of file browserrun.h.
Constructor & Destructor Documentation
BrowserRun::BrowserRun | ( | const KUrl & | url, | |
const KParts::OpenUrlArguments & | args, | |||
const KParts::BrowserArguments & | browserArgs, | |||
KParts::ReadOnlyPart * | part, | |||
QWidget * | window, | |||
bool | removeReferrer, | |||
bool | trustedSource, | |||
bool | hideErrorDialog = false | |||
) |
- Parameters:
-
url the URL we're probing args URL args - includes reload, metaData, etc. browserArgs browser-related args - includes data for a HTTP POST, etc. part the part going to open this URL - can be 0 if not created yet window the mainwindow - passed to KIO::Job::setWindow() removeReferrer if true, the "referrer" metadata from args
isn't passed ontrustedSource 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 53 of file browserrun.cpp.
BrowserRun::~BrowserRun | ( | ) | [virtual] |
Definition at line 69 of file browserrun.cpp.
Member Function Documentation
Definition at line 301 of file browserrun.cpp.
KParts::OpenUrlArguments & KParts::BrowserRun::arguments | ( | ) |
Definition at line 561 of file browserrun.cpp.
BrowserRun::AskSaveResult BrowserRun::askEmbedOrSave | ( | const KUrl & | url, | |
const QString & | mimeType, | |||
const QString & | suggestedFileName = QString() , |
|||
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 362 of file browserrun.cpp.
BrowserRun::AskSaveResult BrowserRun::askSave | ( | const KUrl & | url, | |
KService::Ptr | offer, | |||
const QString & | mimeType, | |||
const QString & | suggestedFileName = QString() | |||
) | [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 file name suggested by the server
- Returns:
- Save, Open or Cancel.
Definition at line 336 of file browserrun.cpp.
KParts::BrowserArguments & KParts::BrowserRun::browserArguments | ( | ) |
Definition at line 566 of file browserrun.cpp.
QString BrowserRun::contentDisposition | ( | ) | const |
- Returns:
- Suggested disposition by the server (e.g. HTTP content-disposition)
Definition at line 557 of file browserrun.cpp.
void BrowserRun::handleError | ( | KJob * | 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 479 of file browserrun.cpp.
BrowserRun::NonEmbeddableResult BrowserRun::handleNonEmbeddable | ( | const QString & | mimeType | ) | [protected] |
Helper for foundMimeType: call this if the mimetype couldn't be embedded.
Definition at line 234 of file browserrun.cpp.
bool BrowserRun::hideErrorDialog | ( | ) | const |
Definition at line 552 of file browserrun.cpp.
void BrowserRun::init | ( | ) | [protected, virtual] |
Definition at line 546 of file browserrun.cpp.
KParts::ReadOnlyPart * BrowserRun::part | ( | ) | const |
Definition at line 74 of file browserrun.cpp.
Definition at line 401 of file browserrun.cpp.
void BrowserRun::scanFile | ( | ) | [protected, virtual] |
bool KParts::BrowserRun::serverSuggestsSave | ( | ) | const [inline] |
Definition at line 75 of file browserrun.h.
void BrowserRun::simpleSave | ( | const KUrl & | url, | |
const QString & | suggestedFileName, | |||
QWidget * | window = 0 | |||
) | [static] |
Definition at line 407 of file browserrun.cpp.
Definition at line 194 of file browserrun.cpp.
void BrowserRun::slotBrowserScanFinished | ( | KJob * | job | ) | [protected, slot] |
Definition at line 171 of file browserrun.cpp.
void BrowserRun::slotCopyToTempFileResult | ( | KJob * | job | ) | [protected, slot] |
Definition at line 533 of file browserrun.cpp.
void BrowserRun::slotStatResult | ( | KJob * | job | ) | [protected, virtual, slot] |
Reimplemented from KRun.
Definition at line 470 of file browserrun.cpp.
KUrl BrowserRun::url | ( | ) | const |
Reimplemented from KRun.
Definition at line 79 of file browserrun.cpp.
The documentation for this class was generated from the following files: