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. |
|
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.