NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Shell Function

Runs an executable program and returns a Variant (Double) representing the program's task ID if successful, otherwise it returns zero.

Shell(pathname[,windowstyle])

Arguments

pathname
Required; String. Name of the program to execute and any required arguments or command-line switches; may include directory or folder and drive.
windowstyle
Optional. Integer corresponding to the style of the window in which the program is to be run. If windowstyle is omitted, the program is started minimized with focus.

The windowstyle named argument has these values:

Constant Value Description
Hide 0 Window is hidden and focus is passed to the hidden window.
NormalFocus 1 Window has focus and is restored to its original size and position.
MinimizedFocus 2 Window is displayed as an icon with focus.
MaximizedFocus 3 Window is maximized with focus.
NormalNoFocus 4 Window is restored to its most recent size and position. The currently active window remains active.
MinimizedNoFocus 6 Window is displayed as an icon. The currently active window remains active.

Remarks

If the Shell function successfully executes the named file, it returns the task ID of the started program. The task ID is a unique number that identifies the running program. If the Shell function can't start the named program, an error occurs.

Note   By default, the Shell function runs other programs asynchronously. This means that a program started with Shell might not finish executing before the statements following the Shell function are executed.

See Also

Example

AppActivate Statement