KRun Class Reference
#include <krun.h>
Inheritance diagram for KRun:

Detailed Description
To open files with their associated applications in KDE, use KRun.Opens files with their associated applications in KDE.It can execute any desktop entry, as well as any file, using the default application or another application "bound" to the file type (or URL protocol).
In that example, the mimetype of the file is not known by the application, so a KRun instance must be created. It will determine the mimetype by itself. If the mimetype is known, or if you even know the service (application) to use for this file, use one of the static methods.
By default KRun uses auto deletion. It causes the KRun instance to delete itself when the it finished its task. If you allocate the KRun object on the stack you must disable auto deletion, otherwise it will crash.
Definition at line 58 of file krun.h.
Signals | |
void | finished () |
void | error () |
Public Member Functions | |
KRun (const KURL &url, mode_t mode=0, bool isLocalFile=false, bool showProgressInfo=true) | |
KRun (const KURL &url, QWidget *window, mode_t mode=0, bool isLocalFile=false, bool showProgressInfo=true) | |
KRun (const KURL &url, QWidget *window, const QCString &asn, mode_t mode=0, bool isLocalFile=false, bool showProgressInfo=true) | |
virtual | ~KRun () |
void | abort () |
bool | hasError () const |
bool | hasFinished () const |
bool | autoDelete () const |
void | setAutoDelete (bool b) |
void | setPreferredService (const QString &desktopEntryName) |
void | setRunExecutables (bool b) |
void | setEnableExternalBrowser (bool b) |
void | setSuggestedFileName (const QString &fileName) |
Static Public Member Functions | |
static pid_t | run (const KService &_service, const KURL::List &_urls, QWidget *window, bool tempFiles=false) |
static pid_t | run (const KService &_service, const KURL::List &_urls, QWidget *window, const QCString &asn, bool tempFiles=false) |
static pid_t | run (const KService &_service, const KURL::List &_urls, bool tempFiles) |
static pid_t | run (const KService &_service, const KURL::List &_urls) |
static pid_t | run (const KService &_service, const KURL::List &_urls, QWidget *window, bool tempFiles, const QString &suggestedFileName) |
static pid_t | run (const KService &_service, const KURL::List &_urls, QWidget *window, const QCString &asn, bool tempFiles, const QString &suggestedFileName) |
static pid_t | run (const QString &_exec, const KURL::List &_urls, const QString &_name=QString::null, const QString &_icon=QString::null, const QString &_obsolete1=QString::null, const QString &_obsolete2=QString::null) |
static pid_t | runURL (const KURL &_url, const QString &_mimetype, bool tempFile, bool runExecutables) |
static pid_t | runURL (const KURL &_url, const QString &_mimetype, bool tempFile) |
static pid_t | runURL (const KURL &_url, const QString &_mimetype) |
static pid_t | runURL (const KURL &_url, const QString &_mimetype, QWidget *window, const QCString &asn, bool tempFile, bool runExecutables, const QString &suggestedFileName) |
static pid_t | runURL (const KURL &_url, const QString &_mimetype, bool tempFile, bool runExecutables, const QString &suggestedFileName) |
static pid_t | runCommand (QString cmd) |
static pid_t | runCommand (const QString &cmd, const QString &execName, const QString &icon) |
static pid_t | runCommand (const QString &cmd, const QString &execName, const QString &icon, QWidget *window, const QCString &asn) |
static bool | displayOpenWithDialog (const KURL::List &lst, bool tempFiles) |
static bool | displayOpenWithDialog (const KURL::List &lst) |
static bool | displayOpenWithDialog (const KURL::List &lst, bool tempFiles, const QString &suggestedFileName) |
static void | shellQuote (QString &_str) |
static QStringList | processDesktopExec (const KService &_service, const KURL::List &_urls, bool has_shell, bool tempFiles) |
static QStringList | processDesktopExec (const KService &_service, const KURL::List &_urls, bool has_shell) |
static QStringList | processDesktopExec (const KService &_service, const KURL::List &_urls, bool has_shell, bool tempFiles, const QString &suggestedFileName) |
static QString | binaryName (const QString &execLine, bool removePath) |
static bool | isExecutable (const QString &serviceType) |
static bool | isExecutableFile (const KURL &url, const QString &mimetype) |
static bool | checkStartupNotify (const QString &binName, const KService *service, bool *silent_arg, QCString *wmclass_arg) |
Protected Slots | |
void | slotTimeout () |
void | slotScanFinished (KIO::Job *) |
void | slotScanMimeType (KIO::Job *, const QString &type) |
virtual void | slotStatResult (KIO::Job *) |
Protected Member Functions | |
virtual void | init () |
virtual void | scanFile () |
virtual void | foundMimeType (const QString &_type) |
virtual void | killJob () |
virtual void | virtual_hook (int id, void *data) |
Protected Attributes | |
KURL | m_strURL |
bool | m_bFault |
bool | m_bAutoDelete |
bool | m_bProgressInfo |
bool | m_bFinished |
KIO::Job * | m_job |
QTimer | m_timer |
bool | m_bScanFile |
bool | m_bIsDirectory |
bool | m_bInit |
bool | m_bIsLocalFile |
mode_t | m_mode |
Constructor & Destructor Documentation
|
Create a KRun object to run the preferred application for a file/URL. KRun will first determine the type of the file, and will then run the associated application.
|
|
BIC: Combine with the above ctor for KDE 4.0.
|
|
Destructor. Don't call it yourself, since a KRun object auto-deletes itself. |
Member Function Documentation
|
Abort this KRun. This kills any jobs launched by it, and leads to deletion if auto-deletion is on. This is much safer than deleting the KRun (in case it's currently showing an error dialog box, for instance) |
|
Checks whether auto delete is activated. Auto-deletion causes the KRun instance to delete itself when it finished its task. By default auto deletion is on.
|
|
Given a full command line (e.g. the Exec= line from a .desktop file), extract the name of the binary being run.
|
|
|
|
Display the Open-With dialog for those URLs, and run the chosen application.
|
|
Emitted when the operation had an error.
|
|
Emitted when the operation finished.
|
|
Called if the mimetype has been detected. The function checks whether the document and appends the gzip protocol to the URL. Otherwise runURL is called to finish the job. |
|
Returns true if the KRun instance has an error.
|
|
Returns true if the KRun instance has finished.
|
|
Returns whether
|
|
Returns wether the To be executable the file must pass the following rules:
|
|
|
|
Processes a Exec= line as found in .desktop files.
|
|
Open a list of URLs with.
|
|
|
|
Open a list of URLs with a certain service (application).
|
|
Open a list of URLs with a certain service (application).
|
|
Same as the other runCommand(), but it also takes the name of the binary, to display an error message in case it couldn't find it.
|
|
Run the given shell command and notifies kicker of the starting of the application. If the program to be called doesn't exist, an error box will be displayed. Use only when you know the full command line. Otherwise use the other static methods, or KRun's constructor.
|
|
|
|
Open the given URL. This function is used after the mime type is found out. It will search for all services which can handle the mime type and call run() afterwards.
|
|
Enables or disabled auto deletion. Auto deletion causes the KRun instance to delete itself when it finished its task. If you allocate the KRun object on the stack you must disable auto deletion. By default auto deletion is on.
|
|
Sets whether the external webbrowser setting should be honoured. This is enabled by default. This should only be disabled in webbrowser applications.
|
|
Set the preferred service for opening this URL, after its mimetype will have been found by KRun. IMPORTANT: the service is only used if its configuration says it can handle this mimetype. This is used for instance for the X-KDE-LastOpenedWith key, for the recent documents list.
|
|
Sets whether executables, .desktop files or shell scripts should be run by KRun. This is enabled by default.
|
|
Sets the file name to use in the case of downloading the file to a tempfile in order to give to a non-url-aware application. Some apps rely on the extension to determine the mimetype of the file. Usually the file name comes from the URL, but in the case of the HTTP Content-Disposition header, we need to override the file name.
|
|
Quotes a string for the shell.
|
Member Data Documentation
|
USed to indicate that the next action is to initialize. This action is invoked from slotTimeout |
|
Used to indicate that the next action is to scan the file. This action is invoked from slotTimeout. |
The documentation for this class was generated from the following files: