<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> <head> <title>KParts.BrowserRun</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <link rel="stylesheet" type="text/css" href="../common/doxygen.css" /> <link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../common/kde.css" /> </head> <body> <div id="container"> <div id="header"> <div id="header_top"> <div> <div> <img alt ="" src="../common/top-kde.jpg"/> KDE 4.9 PyKDE API Reference </div> </div> </div> <div id="header_bottom"> <div id="location"> <ul> <li>KDE's Python API</li> </ul> </div> <div id="menu"> <ul> <li><a href="../modules.html">Overview</a></li> <li><a href="http://techbase.kde.org/Development/Languages/Python">PyKDE Home</a></li> <li><a href="http://kde.org/family/">Sitemap</a></li> <li><a href="http://kde.org/contact/">Contact Us</a></li> </ul> </div> </div> </div> <div id="body_wrapper"> <div id="body"> <div id="right"> <div class="content"> <div id="main"> <div class="clearer"> </div> <h1>BrowserRun Class Reference</h1> <code>from PyKDE4.kparts import *</code> <p> Inherits: <a href="../kio/KRun.html">KRun</a> → QObject<br /> Namespace: <a href="../kparts/KParts.html">KParts</a><br /> <h2>Detailed Description</h2> <p>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 <dl class="author" compact><dt><b>Author:</b></dt><dd> David Faure <faure@kde.org> </dd></dl> </p> <table border="0" cellpadding="0" cellspacing="0"><tr><td colspan="2"><br><h2>Enumerations</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#AskEmbedOrSaveFlags">AskEmbedOrSaveFlags</a> </td><td class="memItemRight" valign="bottom">{ InlineDisposition, AttachmentDisposition }</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#AskSaveResult">AskSaveResult</a> </td><td class="memItemRight" valign="bottom">{ Save, Open, Cancel }</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="#NonEmbeddableResult">NonEmbeddableResult</a> </td><td class="memItemRight" valign="bottom">{ Handled, NotHandled, Delayed }</td></tr> <tr><td colspan="2"><br><h2>Methods</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#BrowserRun">__init__</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> url, <a href="../kparts/KParts.OpenUrlArguments.html">KParts.OpenUrlArguments</a> args, <a href="../kparts/KParts.BrowserArguments.html">KParts.BrowserArguments</a> browserArgs, <a href="../kparts/KParts.ReadOnlyPart.html">KParts.ReadOnlyPart</a> part, QWidget window, bool removeReferrer, bool trustedSource, bool hideErrorDialog=0)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kparts/KParts.OpenUrlArguments.html">KParts.OpenUrlArguments</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#arguments">arguments</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kparts/KParts.BrowserArguments.html">KParts.BrowserArguments</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#browserArguments">browserArguments</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><a class="el" href="#contentDisposition">contentDisposition</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#handleError">handleError</a> (self, <a href="../kdecore/KJob.html">KJob</a> job)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kparts/KParts.BrowserRun.html#NonEmbeddableResult">KParts.BrowserRun.NonEmbeddableResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#handleNonEmbeddable">handleNonEmbeddable</a> (self, QString mimeType, KSharedPtr<KService> pSelectedService)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#hideErrorDialog">hideErrorDialog</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#init">init</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kparts/KParts.ReadOnlyPart.html">KParts.ReadOnlyPart</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#part">part</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#save">save</a> (self, <a href="../kdecore/KUrl.html">KUrl</a> url, QString suggestedFileName)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#scanFile">scanFile</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#serverSuggestsSave">serverSuggestsSave</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#slotBrowserMimetype">slotBrowserMimetype</a> (self, <a href="../kio/KIO.Job.html">KIO.Job</a> job, QString type)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#slotBrowserScanFinished">slotBrowserScanFinished</a> (self, <a href="../kdecore/KJob.html">KJob</a> job)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#slotCopyToTempFileResult">slotCopyToTempFileResult</a> (self, <a href="../kdecore/KJob.html">KJob</a> job)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#slotStatResult">slotStatResult</a> (self, <a href="../kdecore/KJob.html">KJob</a> job)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.html">KUrl</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#url">url</a> (self)</td></tr> <tr><td colspan="2"><br><h2>Static Methods</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#allowExecution">allowExecution</a> (QString mimeType, <a href="../kdecore/KUrl.html">KUrl</a> url)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kparts/KParts.BrowserRun.html#AskSaveResult">KParts.BrowserRun.AskSaveResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#askEmbedOrSave">askEmbedOrSave</a> (<a href="../kdecore/KUrl.html">KUrl</a> url, QString mimeType, QString suggestedFileName=QString(), int flags=0)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kparts/KParts.BrowserRun.html#AskSaveResult">KParts.BrowserRun.AskSaveResult</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#askSave">askSave</a> (<a href="../kdecore/KUrl.html">KUrl</a> url, KSharedPtr<KService> offer, QString mimeType, QString suggestedFileName=QString())</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="#isTextExecutable">isTextExecutable</a> (QString mimeType)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"><a href="../kdecore/KUrl.html">KUrl</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#makeErrorUrl">makeErrorUrl</a> (int error, QString errorText, QString initialUrl)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#saveUrl">saveUrl</a> (<a href="../kdecore/KUrl.html">KUrl</a> url, QString suggestedFileName, QWidget window, <a href="../kparts/KParts.OpenUrlArguments.html">KParts.OpenUrlArguments</a> args)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#saveUrlUsingKIO">saveUrlUsingKIO</a> (<a href="../kdecore/KUrl.html">KUrl</a> srcUrl, <a href="../kdecore/KUrl.html">KUrl</a> destUrl, QWidget window, {QString:QString} metaData)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#simpleSave">simpleSave</a> (<a href="../kdecore/KUrl.html">KUrl</a> url, QString suggestedFileName, QWidget window=0)</td></tr> </table> <hr><h2>Method Documentation</h2><a class="anchor" name="BrowserRun"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">__init__</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>url</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kparts/KParts.OpenUrlArguments.html">KParts.OpenUrlArguments</a> </td> <td class="paramname"><em>args</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kparts/KParts.BrowserArguments.html">KParts.BrowserArguments</a> </td> <td class="paramname"><em>browserArgs</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kparts/KParts.ReadOnlyPart.html">KParts.ReadOnlyPart</a> </td> <td class="paramname"><em>part</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QWidget </td> <td class="paramname"><em>window</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>removeReferrer</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>trustedSource</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>hideErrorDialog=0</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p></p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>url</em> </td><td> the URL we're probing <tr><td></td><td valign="top"><em>args</em> </td><td> URL args - includes reload, metaData, etc. <tr><td></td><td valign="top"><em>browserArgs</em> </td><td> browser-related args - includes data for a HTTP POST, etc. <tr><td></td><td valign="top"><em>part</em> </td><td> the part going to open this URL - can be 0 if not created yet <tr><td></td><td valign="top"><em>window</em> </td><td> the mainwindow - passed to KIO.Job.setWindow() <tr><td></td><td valign="top"><em>removeReferrer</em> </td><td> if true, the "referrer" metadata from <b>args</b> isn't passed on <tr><td></td><td valign="top"><em>trustedSource</em> </td><td> if false, a warning will be shown before launching an executable. Always pass false for <b>trustedSource,</b> except for local directory views. <tr><td></td><td valign="top"><em>hideErrorDialog</em> </td><td> if true, no dialog will be shown in case of errors. </td></tr> </table></dl> <p> </p></div></div><a class="anchor" name="arguments"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"><a href="../kparts/KParts.OpenUrlArguments.html">KParts.OpenUrlArguments</a> arguments</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"></div></div><a class="anchor" name="browserArguments"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"><a href="../kparts/KParts.BrowserArguments.html">KParts.BrowserArguments</a> browserArguments</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"></div></div><a class="anchor" name="contentDisposition"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">QString contentDisposition</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"><p><dl class="return" compact><dt><b>Returns:</b></dt><dd> Suggested disposition by the server (e.g. HTTP content-disposition) </dd></dl> </p></div></div><a class="anchor" name="handleError"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> handleError</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kdecore/KJob.html">KJob</a> </td> <td class="paramname"><em>job</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Called when an error happens. NOTE: <b>job</b> 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. </p></div></div><a class="anchor" name="handleNonEmbeddable"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"><a href="../kparts/KParts.BrowserRun.html#NonEmbeddableResult">KParts.BrowserRun.NonEmbeddableResult</a> handleNonEmbeddable</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>mimeType</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">KSharedPtr<KService> </td> <td class="paramname"><em>pSelectedService</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Helper for foundMimeType: call this if the mimetype couldn't be embedded </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>mimeType</em> </td><td> the mimetype found for the URL <tr><td></td><td valign="top"><em>pSelectedService</em> </td><td> Output variable: pointer to a KService.Ptr, which will be set to the service selected in the BrowserOpenOrSaveQuestion dialog, if any. </td></tr> </table></dl> <p> How to handle this properly: if pSelectedService is non-zero, then the dialog will show additional "open with" buttons. In your code, you should write: <pre class="fragment"> if (selectedService) { KRun.setPreferredService(selectedService->desktopEntryName()); // and let this code path fall back to KRun.foundMimeType(mimeType); } else { KRun.displayOpenWithDialog(url(), m_window, false, suggestedFileName()); setFinished(true); } </pre> </p> <p> <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.5 </dd></dl> </p></div></div><a class="anchor" name="hideErrorDialog"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">bool hideErrorDialog</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"></div></div><a class="anchor" name="init"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> init</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"><p>Reimplemented from KRun </p></div></div><a class="anchor" name="part"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"><a href="../kparts/KParts.ReadOnlyPart.html">KParts.ReadOnlyPart</a> part</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"></div></div><a class="anchor" name="save"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> save</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>url</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>suggestedFileName</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"></div></div><a class="anchor" name="scanFile"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> scanFile</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"><p>Reimplemented from KRun </p></div></div><a class="anchor" name="serverSuggestsSave"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">bool serverSuggestsSave</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"><p><dl class="return" compact><dt><b>Returns:</b></dt><dd> Wheter the returned disposition suggests saving or opening inline </dd></dl> </p></div></div><a class="anchor" name="slotBrowserMimetype"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> slotBrowserMimetype</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kio/KIO.Job.html">KIO.Job</a> </td> <td class="paramname"><em>job</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>type</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"></div></div><a class="anchor" name="slotBrowserScanFinished"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> slotBrowserScanFinished</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kdecore/KJob.html">KJob</a> </td> <td class="paramname"><em>job</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"></div></div><a class="anchor" name="slotCopyToTempFileResult"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> slotCopyToTempFileResult</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kdecore/KJob.html">KJob</a> </td> <td class="paramname"><em>job</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"></div></div><a class="anchor" name="slotStatResult"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> slotStatResult</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kdecore/KJob.html">KJob</a> </td> <td class="paramname"><em>job</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"></div></div><a class="anchor" name="url"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"><a href="../kdecore/KUrl.html">KUrl</a> url</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"></div></div><hr><h2>Static Method Documentation</h2><a class="anchor" name="allowExecution"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">bool allowExecution</td> <td>(</td> <td class="paramtype">QString </td> <td class="paramname"><em>mimeType</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>url</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"></div></div><a class="anchor" name="askEmbedOrSave"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"><a href="../kparts/KParts.BrowserRun.html#AskSaveResult">KParts.BrowserRun.AskSaveResult</a> askEmbedOrSave</td> <td>(</td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>url</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>mimeType</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>suggestedFileName=QString()</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>flags=0</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>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). </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>url</em> </td><td> the URL in question <tr><td></td><td valign="top"><em>mimeType</em> </td><td> the mimetype of the URL <tr><td></td><td valign="top"><em>suggestedFileName</em> </td><td> optional filename suggested by the server <tr><td></td><td valign="top"><em>flags</em> </td><td> set to AttachmentDisposition if suggested by the server </td></tr> </table></dl> <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> Save, Open or Cancel. </dd></dl> <dl class="deprecated" compact><dt><b>Deprecated:</b></dt><dd> use BrowserOpenOrSaveQuestion </dd></dl> <pre class="fragment"> BrowserOpenOrSaveQuestion dlg(parent, url, mimeType, suggestedFileName); const BrowserOpenOrSaveQuestion.Result res = dlg.askEmbedOrSave(flags); // Important: returns Embed now, not Open! </pre> </p></div></div><a class="anchor" name="askSave"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"><a href="../kparts/KParts.BrowserRun.html#AskSaveResult">KParts.BrowserRun.AskSaveResult</a> askSave</td> <td>(</td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>url</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">KSharedPtr<KService> </td> <td class="paramname"><em>offer</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>mimeType</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>suggestedFileName=QString()</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Ask the user whether to save or open a url in another application. </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>url</em> </td><td> the URL in question <tr><td></td><td valign="top"><em>offer</em> </td><td> the application that will be used to open the URL <tr><td></td><td valign="top"><em>mimeType</em> </td><td> the mimetype of the URL <tr><td></td><td valign="top"><em>suggestedFileName</em> </td><td> optional file name suggested by the server </td></tr> </table></dl> <p> <dl class="return" compact><dt><b>Returns:</b></dt><dd> Save, Open or Cancel. </dd></dl> <dl class="deprecated" compact><dt><b>Deprecated:</b></dt><dd> use BrowserOpenOrSaveQuestion </dd></dl> <pre class="fragment"> BrowserOpenOrSaveQuestion dlg(parent, url, mimeType, suggestedFileName); const BrowserOpenOrSaveQuestion.Result res = dlg.askOpenOrSave(); </pre> </p></div></div><a class="anchor" name="isTextExecutable"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">bool isTextExecutable</td> <td>(</td> <td class="paramtype">QString </td> <td class="paramname"><em>mimeType</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"></div></div><a class="anchor" name="makeErrorUrl"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"><a href="../kdecore/KUrl.html">KUrl</a> makeErrorUrl</td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>error</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>errorText</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>initialUrl</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>KDE webbrowsing kparts support error urls to display errors in-line in the browser component. This helper method creates the error URL from its parameters. </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>error</em> </td><td> the KIO error code (or KIO.ERR_SLAVE_DEFINED if not from KIO) <tr><td></td><td valign="top"><em>errorText</em> </td><td> the text of the error message <tr><td></td><td valign="top"><em>initialUrl</em> </td><td> the URL that we were trying to open (as a string, so that this can support invalid URLs as well) </td></tr> </table></dl> <p> <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.6 </dd></dl> </p></div></div><a class="anchor" name="saveUrl"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> saveUrl</td> <td>(</td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>url</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>suggestedFileName</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QWidget </td> <td class="paramname"><em>window</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kparts/KParts.OpenUrlArguments.html">KParts.OpenUrlArguments</a> </td> <td class="paramname"><em>args</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>If kget integration is enabled, passes the url to kget. Otherwise, asks the user for a destination url, and calls saveUrlUsingKIO. <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.4 </dd></dl> </p></div></div><a class="anchor" name="saveUrlUsingKIO"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> saveUrlUsingKIO</td> <td>(</td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>srcUrl</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>destUrl</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QWidget </td> <td class="paramname"><em>window</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">{QString:QString} </td> <td class="paramname"><em>metaData</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Starts the KIO file copy job to download <b>srcUrl</b> into <b>destUrl.</b> <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.4 </dd></dl> </p></div></div><a class="anchor" name="simpleSave"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> simpleSave</td> <td>(</td> <td class="paramtype"><a href="../kdecore/KUrl.html">KUrl</a> </td> <td class="paramname"><em>url</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>suggestedFileName</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QWidget </td> <td class="paramname"><em>window=0</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"></div></div><hr><h2>Enumeration Documentation</h2><a class="anchor" name="AskEmbedOrSaveFlags"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr><td class="memname">AskEmbedOrSaveFlags</td> </tr> </table> </div> <div class="memdoc"><dl compact><dt><b>Enumerator: </b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>InlineDisposition</em> = 0</td><td><tr><td valign="top"><em>AttachmentDisposition</em> = 1</td><td></table> </dl> </div></div><p><a class="anchor" name="AskSaveResult"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr><td class="memname">AskSaveResult</td> </tr> </table> </div> <div class="memdoc"><dl compact><dt><b>Enumerator: </b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>Save</em> </td><td><tr><td valign="top"><em>Open</em> </td><td><tr><td valign="top"><em>Cancel</em> </td><td></table> </dl> </div></div><p><a class="anchor" name="NonEmbeddableResult"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr><td class="memname">NonEmbeddableResult</td> </tr> </table> </div> <div class="memdoc"><p>NotHandled means that foundMimeType should call KRun.foundMimeType, i.e. launch an external app. </p><dl compact><dt><b>Enumerator: </b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"><tr><td valign="top"><em>Handled</em> </td><td><tr><td valign="top"><em>NotHandled</em> </td><td><tr><td valign="top"><em>Delayed</em> </td><td></table> </dl> </div></div><p> </div> </div> </div> <div id="left"> <div class="menu_box"> <div class="nav_list"> <ul> <li><a href="../allclasses.html">Full Index</a></li> </ul> </div> <a name="cp-menu" /><div class="menutitle"><div> <h2 id="cp-menu-project">Modules</h2> </div></div> <div class="nav_list"> <ul><li><a href="../akonadi/index.html">akonadi</a></li> <li><a href="../dnssd/index.html">dnssd</a></li> <li><a href="../kdecore/index.html">kdecore</a></li> <li><a href="../kdeui/index.html">kdeui</a></li> <li><a href="../khtml/index.html">khtml</a></li> <li><a href="../kio/index.html">kio</a></li> <li><a href="../knewstuff/index.html">knewstuff</a></li> <li><a href="../kparts/index.html">kparts</a></li> <li><a href="../kutils/index.html">kutils</a></li> <li><a href="../nepomuk/index.html">nepomuk</a></li> <li><a href="../phonon/index.html">phonon</a></li> <li><a href="../plasma/index.html">plasma</a></li> <li><a href="../polkitqt/index.html">polkitqt</a></li> <li><a href="../solid/index.html">solid</a></li> <li><a href="../soprano/index.html">soprano</a></li> </ul></div></div> </div> </div> <div class="clearer"/> </div> <div id="end_body"></div> </div> <div id="footer"><div id="footer_text"> This documentation is maintained by <a href="mailto:simon@simonzone.com">Simon Edwards</a>.<br /> KDE<sup>®</sup> and <a href="../images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> | <a href="http://www.kde.org/contact/impressum.php">Legal</a> </div></div> </body> </html>