ShellExecute - method of object Pm
Description:
Running or printing the file or the registered document.
Syntax:
ShellExecute(sOperation, sFile, sParameters, sFolder, nShow)
Calling:
n = Pm.ShellExecute(sOperation, sFile, sParameters, sFolder, nShow)Parameters:
| sOperation | (String) Type of operation with the file. If the parameter is empty string, then the value "open" is set. "open" - The file has to be opened along with the associated application "print" - The file has to be printed |
|---|
| sFile | (String) The file name with the path. If a full path is not entered, then it is completed relative to the application file folder. It is recommended to use the PROMOTIC path syntax - see PROMOTIC path to files and folders. |
|---|
| sParameters | (String) Parameters that have to be passed to the application associated to the running file |
|---|
| sFolder | (String) Path to the working folder of the application. It is recommended to use the PROMOTIC path syntax - see PROMOTIC path to files and folders. |
|---|
| nShow | (Long) Display mode of the application associated to the file: 0 - hidden 1 - normal active 2 - minimized active 3 - maximized active 4 - normal not active 6 - minimized not active |
|---|
Return Values:
If the operation passed successfully, then the method returns the value 0, otherwise it returns the error number:
1 - out of memory
3 - the specified file has not been found
4 - the specified path has not been found
Note:
The method serves to running or printing a
*.exe file or the file that is registered in the
OS Windows along with the associated application.
This method
is not functional for
Web panels in
JavaScript language (and therefore it is not working in
Web panels).
Example1:
Print the text document "experiment.htm" in the Internet Explorer:
JavaScriptVBScriptSelect and copy to clipboard
Pm.ShellExecute("print", "#app:experiment.htm", "", "#app:", 0);
Pm.ShellExecute "print", "#app:experiment.htm", "", "#app:", 0Example2:
Displays the Windows system window for the network printer "\\SERVER\PRINTER1:"
JavaScriptVBScriptSelect and copy to clipboard
Pm.ShellExecute("", "\\\\SERVER\\PRINTER1", "", "", 0);
Pm.ShellExecute "", "\\SERVER\PRINTER1", "", "", 0Example3:
Launching the PowerPoint application.
JavaScriptVBScriptSelect and copy to clipboard
Pm.ShellExecute("open", "C:\\PowerPoint\\presentation.pps", "", "C:\\PowerPoint\\", 1);
Pm.ShellExecute "open", "C:\PowerPoint\presentation.pps", "", "C:\PowerPoint\", 1