Shell

betrifft

Die Shell-Funktion führt eine Anwendung aus, die mit der in Path angegebenen Datei verknüpft ist. Falls die Funktion erfolgreich ausgeführt wurde, gibt sie die Prozess-ID der gestarteten Anwendung zurück.

 

Syntax

Shell(Path [, Parameter] [, Directory] [, Verb] [, WindowStyle] [, Wait])

Rückgabewert

Typ

Beschreibung

Long

Prozess-ID des gestarteten Programmes

Parameter

Verwendung

Name

Typ

Übergabe

Beschreibung

Erforderlich

Path

String

ByVal

Pfad zur ausführbaren Datei

Optional

Parameter

String

ByVal

Kommandozeilenparameter der Anwendung

Optional

Directory

String

ByVal

Das Arbeitsverzeichnis der zu startenden Anwendung

Optional

Verb

String

ByVal

Die Ausführungsform der zu startenden Anwendung. Falls nicht angegeben, enthält Verb den Wert „open“

Optional

WindowStyle

Long

ByVal

Darstellungsform des 1. Fensters der zu startenden Anwendung

Optional

Wait

Boolean

ByVal

Warten auf die Beendigung des Programmes; Voreinstellung ist False

 

Wenn die Shell-Funktion die angegebene Datei erfolgreich ausführt, liefert sie die Process-ID des gestarteten Programms zurück. Die Process -ID ist eine Zahl, die das ausgeführte Programm eindeutig kennzeichnet. Wenn die Shell-Funktion das angegebene Programm nicht starten kann, tritt ein Fehler auf und es wird Null zurückgegeben.

Übergeben Sie mit dem Parameter Path nur den Name des auszuführenden Programms.

Über Parameter (optional) können alle erforderlichen Argumente oder Befehlszeilen-Optionen angegeben werden.

Der optionale Parameter Directory bestimmt das Arbeitsverzeichnis unter dem die Anwendung ausgeführt wird.

Der optionale Parameter Verb bestimmt die Art der Operation:

 

Verb

Beschreibung

Open

Die Datei wird mit der verknüpften Anwendung geöffnet. Bei der angegebenen Datei im Parameter Path kann es sich auch um eine Exe handeln.

Print

Die Datei im Parameter Path wird mit der verknüpften Anwendung gedruckt.

Runas

Die Datei wird mit der verknüpften Anwendung geöffnet. Bei der angegebenen Datei im Parameter Path kann es sich auch um eine Exe handeln. Die Datei wird im Administrator-Modus geöffnet.

 

Der optionale Parameter WindowStyle gibt den Stil des Fensters an, in dem das Programm ausgeführt werden soll. Wenn WindowStyle nicht angegeben wird, erhält das Programm den Fokus und wird im minimierten Zustand gestartet.

Folgende Werte können für WindowStyle übergeben werden:

 

ShellWindowStyles

Beschreibung

0 – SWSHide

Das erste Anwendungsfenster wird ausgeblendet.

1 – SWSShowNormal

Das erste Anwendungsfenster wird normal angezeigt und erhält den Focus

2 – SWSShowMinimized

Das erste Anwendungsfenster wird minimiert angezeigt und erhält den Focus.

3 – SWSShowMaximized

Das erste Anwendungsfenster wird maximiert angezeigt. Das Fenster erhält den Focus.

4 – SWSShowBest

Das erste Anwendungsfenster wird angezeigt und erhält den Focus. Shell versucht das Fenster in bestmöglicher Form anzuzeigen.

7 - SWSShowMinNotActivated

Das erste Fenster wird minimiert angezeigt und nicht aktiviert

8 – SWSShowNotActivated

Das erste Fenster wird normal angezeigt, jedoch nicht aktiviert

 

Der optionale Parameter Wait gibt an, ob TCE mit der Ausführung weiteren Codes warten soll, bis der gestartete Prozess wieder beendet ist.