IShellDispatch2.ShellExecute-Methode

Führt einen angegebenen Vorgang für eine angegebene Datei aus.

Syntax

iRetVal = IShellDispatch2.ShellExecute(
  sFile,
  [ vArguments ],
  [ vDirectory ],
  [ vOperation ],
  [ vShow ]
)

IShellDispatch2.ShellExecute( _
  ByVal sFile As BSTR, _
  [ ByVal vArguments As Variant ], _
  [ ByVal vDirectory As Variant ], _
  [ ByVal vOperation As Variant ], _
  [ ByVal vShow As Variant ] _
) As Integer

Parameter

sFile [in]

Typ: BSTR

Eine Zeichenfolge , die den Namen der Datei enthält, für die ShellExecute die durch vOperation angegebene Aktion ausführt.

vArguments [in, optional]

Typ: Variant

Eine Zeichenfolge, die Parameterwerte für den Vorgang enthält.

vDirectory [in, optional]

Typ: Variant

Der vollqualifizierte Pfad des Verzeichnisses, das die durch sFile angegebene Datei enthält. Wenn dieser Parameter nicht angegeben ist, wird das aktuelle Arbeitsverzeichnis verwendet.

vOperation [in, optional]

Typ: Variant

Der Vorgang, der ausgeführt werden soll. Dieser Wert wird auf eine der Verbzeichenfolgen festgelegt, die von der Datei unterstützt werden. Eine Erläuterung der Verben finden Sie im Abschnitt Hinweise. Wenn dieser Parameter nicht angegeben ist, wird der Standardvorgang ausgeführt.

vShow [in, optional]

Typ: Variant

Eine Empfehlung, wie das Anwendungsfenster anfänglich angezeigt werden soll. Die Anwendung kann diese Empfehlung ignorieren. Dieser Parameter kann einen der folgenden Werte annehmen. Wenn dieser Parameter nicht angegeben ist, verwendet die Anwendung ihren Standardwert.

Wert	Bedeutung
0	Öffnen Sie die Anwendung mit einem ausgeblendeten Fenster.
1	Öffnen Sie die Anwendung mit einem normalen Fenster. Wenn das Fenster minimiert oder maximiert wird, wird es vom System auf seine ursprüngliche Größe und Position wiederhergestellt.
2	Öffnen Sie die Anwendung mit einem minimierten Fenster.
3	Öffnen Sie die Anwendung mit einem maximierten Fenster.
4	Öffnen Sie die Anwendung mit ihrem Fenster auf der neuesten Größe und Position. Das aktive Fenster bleibt aktiv.
5	Öffnen Sie die Anwendung mit ihrem Fenster in ihrer aktuellen Größe und Position.
7	Öffnen Sie die Anwendung mit einem minimierten Fenster. Das aktive Fenster bleibt aktiv.
10	Öffnen Sie die Anwendung mit ihrem Fenster im Standardzustand, der von der Anwendung angegeben wird.

 

Bemerkungen

Diese Methode wird über die Shell.ShellExecute-Methode implementiert und darauf zugegriffen.

Diese Methode entspricht dem Starten eines der Befehle, die dem Kontextmenü einer Datei zugeordnet sind. Jeder Befehl wird durch eine Verbzeichenfolge dargestellt. Der Satz der unterstützten Verben variiert von Datei zu Datei. Das am häufigsten unterstützte Verb ist "open", was in der Regel auch das Standardverb ist. Andere Verben werden möglicherweise nur von bestimmten Dateitypen unterstützt. Weitere Informationen zu Shellverben finden Sie unter Starten von Anwendungen oder Erweitern von Kontextmenüs.

Diese Methode ist derzeit in Microsoft Visual Basic nicht verfügbar.

Beispiele

Die folgenden Beispiele zeigen die Verwendung von ShellExecute zum Öffnen von Editor. Die Verwendung wird für JScript und VBScript angezeigt.

Jscript:

<script language="JScript">
    function fnShellExecuteJ()
    {
        var objShell = new ActiveXObject("shell.application");
        
        objShell.ShellExecute("notepad.exe", "", "", "open", 1);
    }
</script>

Vbscript:

<script language="VBScript">
    function fnShellExecuteVB()
        dim objShell

        set objShell = CreateObject("shell.application")

        objShell.ShellExecute "notepad.exe", "", "", "open", 1

        set objShell = nothing
    end function
</script>

Anforderungen