Run PowerScript function
Description
Runs the specified application program.
Syntax
|
1 |
<span>Run</span> ( <span>string</span> {, <span>windowstate</span> } ) |
|
Argument |
Description |
|---|---|
|
string |
A string whose value is the file name |
|
windowstate (optional) |
A value of the WindowState enumerated
|
Return Values
Integer. Returns 1 if it is successful
and -1 if an error occurs. If any argument’s value is null, Run returns null.
Usage
You can use Run for any program that you
can run from the operating system. If you do not specify parameters, Run opens
the application and displays the first application window. If you
specify windowstate, the application window is
displayed in the specified state.
If you specify parameters, the application determines the
meaning of those parameters. A typical use is to identify a data
file to be opened when the program is executed. If you are running
another PowerBuilder application, that application can call the CommandParm function
to retrieve the parameters and process them as it sees fit.
If the file extension is omitted from the file name, PowerBuilder
assumes the extension is .EXE. To run a program
with another extension (for example, .BAT,
.COM, or .PIF), you must
specify the extension.
Examples
This statement runs the Microsoft Windows Clock accessory
application in its normal size:
|
1 |
<span>Run</span>("Clock") |
This statement runs the Microsoft Windows Clock accessory
application minimized:
|
1 |
<span>Run</span>("Clock", Minimized!) |
This statement runs the program WINNER.COM on
the C drive in a maximized state. The parameter passed to WINNER.COM opens
the file EMPLOYEE.INF:
|
1 |
<span>Run</span>("C:WINNER.COM EMPLOYEE.INF", Maximized!) |
This example runs the DOS batch file MYBATCH.BAT and
passes the parameter TEST to
the batch file. In the batch file, you include percent substitution
characters in the commands to indicate where the parameter is used:
|
1 |
<span>Run</span>("MYBATCH.BAT TEST") |
In the batch file the following statement renames FILE1 to TEST:
|
1 |
RENAME c:PBFILE1 %1 |