org.kde.koala
public class KRun extends QObject
UNKNOWN: Opens files with their associated applications in KDE.
Constructor Summary | |
---|---|
protected | KRun(Class dummy) |
KRun(KURL url, long mode, boolean isLocalFile, boolean showProgressInfo)
Create a KRun object to run the preferred application for a file/URL.
| |
KRun(KURL url, long mode, boolean isLocalFile) | |
KRun(KURL url, long mode) | |
KRun(KURL url) | |
KRun(KURL url, QWidget window, long mode, boolean isLocalFile, boolean showProgressInfo)
BIC: Combine with the above ctor for KDE 4.0. | |
KRun(KURL url, QWidget window, long mode, boolean isLocalFile) | |
KRun(KURL url, QWidget window, long mode) | |
KRun(KURL url, QWidget window) |
Method Summary | |
---|---|
void | abort()
Abort this KRun. |
boolean | autoDelete()
Checks whether auto delete is activated.
|
static String | binaryName(String execLine, boolean removePath)
Given a full command line (e.g. the Exec= line from a .desktop file),
extract the name of the binary being run. |
static boolean | checkStartupNotify(String binName, KService service, boolean[] silent_arg, StringBuffer wmclass_arg) |
String | className() |
static boolean | displayOpenWithDialog(ArrayList lst, boolean tempFiles)
Display the Open-With dialog for those URLs, and run the chosen application. |
static boolean | displayOpenWithDialog(ArrayList lst) |
void | dispose() Delete the wrapped C++ instance ahead of finalize() |
protected void | finalize() Deletes the wrapped C++ instance |
protected void | foundMimeType(String _type)
Called if the mimetype has been detected. |
boolean | hasError()
Returns true if the KRun instance has an error. |
boolean | hasFinished()
Returns true if the KRun instance has finished. |
protected void | init() |
boolean | isDisposed() Has the wrapped C++ instance been deleted? |
static boolean | isExecutable(String serviceType)
Returns whether serviceType refers to an executable program instead
of a data file. |
static boolean | isExecutableFile(KURL url, String mimetype)
Returns wether the url of mimetype is executable.
|
protected void | killJob() |
QMetaObject | metaObject() |
static ArrayList | processDesktopExec(KService _service, ArrayList _urls, boolean has_shell, boolean tempFiles)
Processes a Exec= line as found in .desktop files. |
static ArrayList | processDesktopExec(KService _service, ArrayList _urls, boolean has_shell) |
static int | run(KService _service, ArrayList _urls, boolean tempFiles)
Open a list of URLs with a certain service (application). |
static int | run(KService _service, ArrayList _urls) |
static int | run(String _exec, ArrayList _urls, String _name, String _icon, String _obsolete1, String _obsolete2)
Open a list of URLs with. |
static int | run(String _exec, ArrayList _urls, String _name, String _icon, String _obsolete1) |
static int | run(String _exec, ArrayList _urls, String _name, String _icon) |
static int | run(String _exec, ArrayList _urls, String _name) |
static int | run(String _exec, ArrayList _urls) |
static int | runCommand(String cmd)
Run the given shell command and notifies kicker of the starting
of the application. |
static int | runCommand(String cmd, String execName, String icon)
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. |
static int | runURL(KURL _url, String _mimetype, boolean tempFile, boolean runExecutables)
Open the given URL.
|
static int | runURL(KURL _url, String _mimetype, boolean tempFile) |
static int | runURL(KURL _url, String _mimetype) |
protected void | scanFile() |
void | setAutoDelete(boolean b)
Enables or disabled auto deletion.
|
void | setEnableExternalBrowser(boolean b)
Sets whether the external webbrowser setting should be honoured.
|
void | setPreferredService(String desktopEntryName)
Set the preferred service for opening this URL, after
its mimetype will have been found by KRun. |
void | setRunExecutables(boolean b)
Sets whether executables, .desktop files or shell scripts should
be run by KRun. |
static void | shellQuote(StringBuffer _str)
Quotes a string for the shell. |
protected void | slotScanFinished(Job arg1) |
protected void | slotScanMimeType(Job arg1, String type) |
protected void | slotStatResult(Job arg1) |
protected void | slotTimeout() |
Parameters: url the URL of the file or directory to 'run' mode The st_mode
field of struct stat. If
you don't know this set it to 0. isLocalFile If this parameter is set to false
then url
is
examined to find out whether it is a local URL or
not. This flag is just used to improve speed, since the
function KURL.isLocalFile is a bit slow. showProgressInfo Whether to show progress information when determining the
type of the file (i.e. when using KIO.stat and KIO.mimetype)
Before you set this to false to avoid a dialog box, think about
a very slow FTP server...
It is always better to provide progress info in such cases.
UNKNOWN: Create a KRun object to run the preferred application for a file/URL.
Parameters: window The top-level widget of the app that invoked this object.
It is used to make sure private information like passwords
are properly handled per application. url the URL of the file or directory to 'run' mode The st_mode
field of struct stat. If
you don't know this set it to 0. isLocalFile If this parameter is set to false
then url
is
examined to find out whether it is a local URL or
not. This flag is just used to improve speed, since the
function KURL.isLocalFile is a bit slow. showProgressInfo Whether to show progress information when determining the
type of the file (i.e. when using KIO.stat and KIO.mimetype)
Before you set this to false to avoid a dialog box, think about
a very slow FTP server...
It is always better to provide progress info in such cases.
UNKNOWN: BIC: Combine with the above ctor for KDE 4.
UNKNOWN: Abort this KRun.
Returns: true if auto deletion is on, false otherwise
UNKNOWN: Checks whether auto delete is activated.
Parameters: execLine the full command line removePath if true, remove a (relative or absolute) path. E.g. /usr/bin/ls becomes ls.
Returns: the name of the binary to run
UNKNOWN: Given a full command line (e.
UNKNOWN:
Parameters: lst the list of applications to run tempFiles if true and lst are local files, they will be deleted when the application exits.
Returns: false if the dialog was canceled
UNKNOWN: Display the Open-With dialog for those URLs, and run the chosen application.
UNKNOWN: Called if the mimetype has been detected.
Returns: true when an error occurred
See Also: KRun
UNKNOWN: Returns true if the KRun instance has an error.
Returns: true if the KRun instance has finished
See Also: KRun
UNKNOWN: Returns true if the KRun instance has finished.
serviceType
refers to an executable program instead
of a data file.UNKNOWN: Returns whether serviceType
refers to an executable program instead of a data file.
url
of mimetype
is executable.
To be executable the file must pass the following rules:
-# Must reside on the local filesystem.
-# Must be marked as executable for the user by the filesystem.
-# The mime type must inherit application/x-executable or application/x-executable-script.
To allow a script to run when the above rules are satisfied add the entryUNKNOWN:
X-KDE-IsAlso=application/x-executable-script
to the mimetype's desktop file. Returns wether the url
of mimetype
is executable.
Parameters: _service the service to extract information from. _urls The urls the service should open. has_shell If true, the arguments are going to be fed into a shell e.g by using system(). If false, the arguments are going to be fed into a exec() kind call. If the arguments are intended for an exec() kind of call and the Exec line contains shell commands then "/bin/sh -c" is added. tempFiles if true and _urls are local files, they will be deleted when the application exits.
Returns: a list of arguments suitable for either system() or exec().
UNKNOWN: Processes a Exec= line as found in .
Parameters: _service the service to run _urls the list of URLs, can be empty (app launched without argument) tempFiles if true and _urls are local files, they will be deleted when the application exits.
Returns: the process id, or 0 on error
UNKNOWN: Open a list of URLs with a certain service (application).
Parameters: _exec the name of the executable, for example "/usr/bin/netscape". _urls the list of URLs to open, can be empty (app launched without argument) _name the logical name of the application, for example "Netscape 4.06". _icon the icon which should be used by the application. _obsolete1 Do not use! _obsolete2 Do not use!
Returns: the process id, or 0 on error
UNKNOWN: Open a list of URLs with.
_cmd
must be a shell command. You must not append "&"
to it, since the function will do that for you.Returns: PID of running command, 0 if it could not be started, 0 - (PID of running command) if command was unsafe for map notification.
UNKNOWN: Run the given shell command and notifies kicker of the starting of the application.
Parameters: cmd must be a shell command. You must not append "&" to it, since the function will do that for you. execName the name of the executable icon icon for app starting notification
Returns: PID of running command, 0 if it could not be started, 0 - (PID of running command) if command was unsafe for map notification.
UNKNOWN: 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.
Parameters: _url the URL to open _mimetype the mime type of the resource tempFile if true and _url is a local file, it will be deleted when the launched application exits. runExecutables if false then local .desktop files, executables and shell scripts will not be run. See also isExecutable().
Returns: the process id, or 0 on error
UNKNOWN: Open the given URL.
Parameters: b true to enable auto deletion, false to disable
UNKNOWN: Enables or disabled auto deletion.
Parameters: b whether to enable the external browser or not.
UNKNOWN: Sets whether the external webbrowser setting should be honoured.
Parameters: desktopEntryName the desktopEntryName of the service, e.g. "kate".
UNKNOWN: Set the preferred service for opening this URL, after its mimetype will have been found by KRun.
Parameters: b whether to run executable files or not.
See Also: KRun
UNKNOWN: Sets whether executables, .
Parameters: _str the string to quote. The quoted string will be written here
UNKNOWN: Quotes a string for the shell.