Navigation:  Entwicklerhilfe > Makro-Referenz >

ShellExecute

Vorherige Seite Nächste Seite

Makro-Funktion ShellExecute

Öffnet die angegebene Datei.

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

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.

 

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.

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 i.d.R. 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.

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

Siehe auch

Makro-Referenz

WaitForApplication

ShowApplication

SetActiveApplication

ExecuteDocuments

admin.ini OpenShellCommand