Home > Handbuch > Entwicklerhilfe > Makro-Referenz OmAPI > ShellExecute ShellExecute |
Dateien öffnen.
Syntax
{ShellExecute[:FileName,Parameter,Show,Flag|ShellCmd]}
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.
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
admin.ini OpenShellCommand