ShellExecute

<< Hilfenavigation einblenden

Home > Handbuch > Entwicklerhilfe > Makro-Referenz OmAPI > ShellExecute

ShellExecute

Makro-Prozedur ShellExecute

Dateien öffnen.

Syntax

{ShellExecute[:FileName,Parameter,Show,Flag|ShellCmd]}

Parameter

FileName: Kompletter Dateiname einer Anwendung oder Dokumentdatei

Parameter: Optionale Befehlszeilenparameter

Show: 1=normale Fenstergröße (Vorgabe), 2=als Symbol starten, 3=maximiert starten

Der vierte Parameter ist entweder ein Flag oder der Windows-Befehlsname:

Flag: "WaitForInputIdle" wartet, bis die Anwendung gestartet ist, "WaitForSingleObject" wartet bis sie beendet ist (der intern verwendete Windows-Befehl ist dann CreateProcess statt ShellExecute). "RunAsAdmin" führt die Anwendung als Administrator aus, Sie müssen den Aufruf bei aktiver Benutzerkontensteuerung (UAC) bestätigen.

ShellCmd: Windows-Befehlsname, beispielsweise "open", "printto", "edit". Standard ist leer=Windows-Standardbefehl bzw. der vorgegebene Wert von OpenShellCommand.

Rückgabewert

Keiner, die Anweisung wird nach Ausführung durch einen Leerstring ersetzt.

Beschreibung

Startet die mit FileName angegebene Anwendung oder Dokumentdatei. Wenn kein Dateiname angegeben ist wird die dem aktuellen Befehl zugeordnete Anwendung gestartet. Wenn in Dateiname keine Anwendung, sondern ein Dokument angegeben ist, dann wird das Dokument in der entsprechenden Windows-Standardanwendung geöffnet.

Hinweis: ShellExecute ändert nicht die aktive Anwendung für nachfolgende Makro-Funktionen. Verwenden Sie dafür SetActiveApplication.

Beispiele

{ShellExecute} startet die aktuelle Anwendung.

{ShellExecute:notepad.exe} startet den Windows-Editor.

{ShellExecute:{CurrApplExe},{CurrDocFileName}} startet die aktuelle Anwendung und übergibt ihr das aktuelle Dokument als Startparameter. Das Dokument wird dann in der Regel von der Anwendung geöffnet. Beachten Sie bei der zweiten Variante bitte das Komma hinter dem Doppelpunkt.

{ShellExecute:notepad.exe,C:\Eigene Dateien\test.txt} startet Notepad und öffnet die Datei "C:\Eigene Dateien\test.txt".

{ShellExecute:C:\Eigene Dateien\test.txt} öffnet die Datei "C:\Eigene Dateien\test.txt" in der Windows-Standardanwendung.

{ShellExecute:{CurrDocFileName}} öffnet das aktuelle Dokument in der Windows-Standardanwendung.

{ShellExecute:{Self:ExeName},/regserver,RunAsAdmin} Office Manager COM-Server registrieren.

Siehe auch

Makro-Referenz

WaitForApplication

ShowApplication

SetActiveApplication

ExecuteDocuments

OpenDocument

admin.ini OpenShellCommand