shellExec
Opens a file on the front-end platform with the program associated to the file extension.
Syntax
ui.Interface.frontCall("standard", "shellExec",
[document, action], [result])
- document - The document file to be opened.
- action - (optional, Windows® Only!) The action to perform, related to the way the file type is registered in Windows Registry.
- result - The execution status (
TRUE
=success,FALSE
=error).
Usage
The "shellExec
" front call opens a file on the front-end platform with the
program associated to the file extension.
Tip: When specifying a file path, pay attention to platform specific
rules regarding directory separators and space characters in file names. When the front-end executes
on a recent Microsoft™ Windows system, you can use the
/
slash character as directory separator,
like on Unix systems. A directory or file name can contain spaces, and there is no need to surround
the path with double quotes in such case. When using backslash directory separators, make sure to
escape backslash characters in string literals with \\
.This front call is mainly designed for the Genero Desktop Client on Windows platforms.
Important: Under X11 Systems, this uses xdg-open, which needs to be
installed and configured on your system. Kfmclient will be used as a workaround
when xdg-open is not available.
Tip: In order to view a document (like a PDF for example), if that document can be
displayed by web browsers, use the launchURL front call
instead, especially if you want to use both the Genero Desktop Client (GDC) and the Genero Browser
Client (GBC) front-ends.