WSH » wshshell » Run
- Syntax:
- WshShell.Run (strCommand [,intWindowStyle] [,bWaitOnReturn])
- strCommand
- Receives a string containing the command that will be run.
- intWindowStyle
- This optional parameter receives an integer corresponding to a window style in the Window Style Values table.
- bWaitOnReturn
- This optional parameter, when set to True, will cause the the script to suspend until the command finishes execution.
The Run method runs an application in a new process.
The Run
method creates a new process and runs the command specified by
strCommand. The optional parameter intWindowStyle is used
to set the window style of the program being run. If the optional
parameter bWaitOnReturn is set to True (default is False), then
Run will return the return value returned by strCommand.
Otherwise it returns 0. Also, if bWaitOnReturn is set to True,
then the script will suspend its execution until strCommand
finishes.
The following table shows the available
settings for intWindowStyle.
Window Style Values
| intWindowsStyle | Settings |
| 0 | Hides the window and activates another window. |
| 1 | Activates and displays a window. If the window is minimized or maximized, the system restores it to its original size and position. An application should specify this flag when displaying the window for the first time. |
| 2 | Activates the window and displays it as a minimized window. |
| 3 | Activates the window and displays it as a maximized window. |
| 4 | Displays a window in its most recent size and position. The active window remains active. |
| 5 | Activates the window and displays it in its current size and position. |
| 6 | Minimizes the specified window and activates the next top-level window in the Z order. |
| 7 | Displays the window as a minimized window. The active window remains active. |
| 8 | Displays the window in its current state. The active window remains active. |
| 9 | Activates and displays the window. If the window is minimized or maximized, the system restores it to its original size and position. An application should specify this flag when restoring a minimized window. |
| 10 | Sets the show state based on the state of the program that started the application. |
Examples
Code:
Set WshShell =
WScript.CreateObject("WScript.Shell")
intReturn =
WshShell.Run("notepad " & WScript.ScriptFullName, 1,
TRUE)
WshShell.Popup "Notepad is now closed."Explanation:
This VBScript code starts Notepad using the script's own full path name as the parameter for Notepad.
Language(s): VBScript
