Shell-Funktion

Artikel
04/07/2023

Führt ein ausführbares Programm aus und gibt einen Variant-Wert (Double) zurück, der bei erfolgreicher Ausführung die Aufgaben-ID des Programms darstellt; andernfalls wird Null zurückgegeben.

Syntax

Shell(pathname, [ windowstyle ])

Die Syntax der Shell-Funktion weist folgende benannte Argumente auf:

Teil Beschreibung

pathname Erforderlich; Variant (String). Name des auszuführenden Programms und alle erforderlichen Argumente oder Befehlszeilenschalter; kann das Verzeichnis oder den Ordner und das Laufwerk enthalten. Auf einem Macintosh-Computer können Sie mithilfe der MacID-Funktion die Signatur einer Anwendung anstelle ihres Namens angeben. Im folgenden Beispiel wird die Signatur für Microsoft Word verwendet: Shell MacID("MSWD")

windowstyle Optional. Variant (Integer) entsprechendem dem Stil des Fensters, in dem das Programm ausgeführt werden soll. Wenn windowstyle nicht angegeben wird, wird das Programm minimiert mit Fokus gestartet. Auf einem Macintosh (System 7.0 oder höher) wird durch windowstyle nur bestimmt, ob die Anwendung den Fokus erhält, wenn sie ausgeführt wird.

Teil	Beschreibung
pathname	Erforderlich; Variant (String). Name des auszuführenden Programms und alle erforderlichen Argumente oder Befehlszeilenschalter; kann das Verzeichnis oder den Ordner und das Laufwerk enthalten. Auf einem Macintosh-Computer können Sie mithilfe der MacID-Funktion die Signatur einer Anwendung anstelle ihres Namens angeben. Im folgenden Beispiel wird die Signatur für Microsoft Word verwendet: `Shell MacID("MSWD")`
windowstyle	Optional. Variant (Integer) entsprechendem dem Stil des Fensters, in dem das Programm ausgeführt werden soll. Wenn windowstyle nicht angegeben wird, wird das Programm minimiert mit Fokus gestartet. Auf einem Macintosh (System 7.0 oder höher) wird durch windowstyle nur bestimmt, ob die Anwendung den Fokus erhält, wenn sie ausgeführt wird.

Das benannte Argument windowstyle hat die folgenden Werte:

Konstante	Wert	Beschreibung
vbHide	0	Das Fenster wird ausgeblendet, und der Fokus wird an das ausgeblendete Fenster übergeben. Die vbHide-Konstante gilt nicht auf Macintosh-Plattformen.
vbNormalFocus	1	Das Fenster besitzt den Fokus und wird wieder in seiner ursprünglichen Größe und Position angezeigt.
vbMinimizedFocus	2	Das Fenster wird als Symbol mit dem Fokus angezeigt.
vbMaximizedFocus	3	Das Fenster ist maximiert und besitzt den Fokus.
vbNormalNoFocus	4	Das Fenster wird in seiner letzten Größe und Position wiederhergestellt. Das derzeit aktive Fenster bleibt aktiv.
vbMinimizedNoFocus	6	Das Fenster wird als Symbol angezeigt. Das derzeit aktive Fenster bleibt aktiv.

Hinweise

Wenn die Shell-Funktion die benannte Datei erfolgreich ausführt, wird die Aufgaben-ID des gestarteten Programms zurückgegeben. Die Aufgaben-ID ist eine eindeutige Nummer, die das aktive Programm kennzeichnet. Wenn die Shell -Funktion das benannte Programm nicht starten kann, tritt ein Fehler auf.

Unter Macintosh wird die Anwendung durch vbNormalFocus, vbMinimizedFocus und vbMaximizedFocus im Vordergrund platziert. vbHide, vbNoFocus und vbMinimizeFocus platzieren die Anwendung im Hintergrund.

Hinweis

Standardmäßig führt die Shell Funktion führt andere Programme asynchron aus. Dies bedeutet, dass ein Programm, das mit Shell gestartet wurde, möglicherweise nicht abgeschlossen wird, bevor die Anweisungen, die auf die Shell-Funktion folgen, ausgeführt werden. Informationen zum Warten auf die Beendigung eines Programms finden Sie unter Ermitteln, wann ein Shellprozess endet.

Beispiel

Dieses Beispiel verwendet die Shell Funktion, um eine vom Benutzer angegebene Anwendung zu starten. Auf einem Macintosh-Computer ist "HD" der Standardlaufwerkname, und Teile des Pfadnamens werden durch Doppelpunkte statt umgekehrten Schrägstrichen getrennt. In ähnlicher Weise würden Sie Macintosh-Ordner anstelle von \WINDOWS angeben.

' Specifying 1 as the second argument opens the application in 
' normal size and gives it the focus.
Dim RetVal
RetVal = Shell("C:\WINDOWS\NOTEPAD.EXE", 1)    ' Open Notepad.

Siehe auch

Funktionen (Visual Basic for Applications)

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.