class KRun

Implements a generic runner, i. More...

Definition#include <krun.h>
InheritsQObject (kdecore)
List of all Methods
Annotated List
Files
Globals
Hierarchy
Index

Public Methods

Signals

Public Static Methods

Protected Methods

Protected Slots

Protected Static Methods

Protected Members


Detailed Description

Implements a generic runner, i.e. the 'exec' functionality of KDE

It can execute any desktop entry, as well as any file, using default binding (service) or another bound service.

 KRun ( const KURL& url, mode_t mode = 0, bool isLocalFile = false, bool showProgressInfo = true )

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.

Parameters:

KRun ()

[virtual]

Destructor. Don't call it yourself, since a KRun object auto-deletes itself.

bool  hasError ()

[const]

bool  hasFinished ()

[const]

bool  autoDelete ()

[const]

By default auto deletion is on.

void  setAutoDelete (bool b)

pid_t  run ( const KService& _service, const KURL::List& _urls )

[static]

Open a list of URLs with a certain service.

Parameters:

pid_t  run ( const QString& _exec, const KURL::List& _urls, const QString& _name = QString::null, const QString& _icon = QString::null, const QString& _mini_icon = QString::null, const QString& _desktop_file = QString::null )

[static]

Open a list of URLs with.

Parameters:

pid_t  runURL ( const KURL& _url, const QString& _mimetype )

[static]

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.

pid_t  runCommand ( QString cmd )

[static]

Run the given command and notifies kicker of the starting of the application.

Use only when you know the full command line. Otherwise use the other static methods, or KRun's constructor.

Parameters:

pid_t  runCommand ( const QString& cmd, const QString & execName, const QString & )

[static]

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. The last argument is now unused but kept for binary compatibility.

void  shellQuote ( QString &_str )

[static]

Quotes a string for the shell

void  finished ()

[signal]

void  error ()

[signal]

void  slotTimeout ()

[protected slot]

void  slotScanFinished ( KIO::Job * )

[protected slot]

void  slotStatResult ( KIO::Job * )

[protected slot]

void  init ()

[protected virtual]

void  scanFile ()

[protected virtual]

void  foundMimeType ( const QString& _type )

[protected virtual]

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.

void  killJob ()

[protected virtual]

KURL m_strURL

[protected]

bool m_bFault

[protected]

bool m_bAutoDelete

[protected]

bool m_bProgressInfo

[protected]

bool m_bFinished

[protected]

KIO::Job * m_job

[protected]

QTimer m_timer

[protected]

bool m_bScanFile

[protected]

Used to indicate that the next action is to scan the file. This action is invoked from slotTimeout.

bool m_bIsDirectory

[protected]

bool m_bInit

[protected]

USed to indicate that the next action is to initialize. This action is invoked from slotTimeout

bool m_bIsLocalFile

[protected]

mode_t m_mode

[protected]

KRunPrivate * d

[protected]

pid_t  runOldApplication ( const QString& _exec, const KURL::List& _urls, bool _allow_multiple )

[protected static]

For remote URLs to be opened with apps that don't support remote URLs. Uses kfmexec.

pid_t  run ( const QString& _cmd )

[protected static]

Runs a shell command.

_cmd must be a quoted shell command. You must not append "&" to it, since the function will do that for you. An example is "<tt>greet 'Hello Torben'</tt>".

Returns: PID of running command, 0 if it could not be started, 0 - (PID of running command) if command was unsafe for map notification.

void  clientStarted ( const QString & execName, const QString & iconName, pid_t pid, const QString & binaryName, bool compliant)

[protected static]

Sends a DCOP signal to Kicker's taskbar to indicate that an application has been started.

Parameters:

QString  binaryName ( const QString & execLine )

[protected static]

Extracts binary name from Exec command line


Generated by: prospector@porky.devel.redhat.com on Fri Nov 3 09:58:58 2000, using kdoc 2.0a42.