Vcl.DdeMan.TDdeClientConv.ExecuteMacro

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ExecuteMacro(Cmd: PAnsiChar; waitFlg: Boolean): Boolean;

C++

bool __fastcall ExecuteMacro(char * Cmd, bool waitFlg);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Vcl.DdeMan.pas
Vcl.DdeMan.hpp
Vcl.DdeMan TDdeClientConv

Beschreibung

Sendet einen String mit einem Makrobefehl an den DDE-Server.

Mit ExecuteMacro können Sie einen einzelnen Makrobefehl an die Server-Anwendung senden. Um mehrere Makrobefehle zu senden, verwenden Sie ExecuteMacroLines. Kann der Makrobefehl erfolgreich an den DDE-Server gesendet werden, gibt ExecuteMacro true zurück, und false, wenn der String nicht gesendet werden kann.

Cmd ist ein nullterminierter String, der den von der Server-Anwendung auszuführenden Makrobefehl enthält. Der tatsächliche Wert von Cmd ist vom DDE-Server abhängig. Die zulässigen Befehle finden Sie in der Dokumentation zum DDE-Server.

WaitFlg legt fest, ob der DDE-Client vor dem Senden weiterer DDE-Transaktionen warten soll, bis der Server das Makro verarbeitet hat. Hat WaitFlg den Wert true, können nachfolgende Aufrufe von ExecuteMacro, ExecuteMacroLines, PokeData, PokeDataLines und RequestData erst ausgeführt werden, nachdem der DDE-Server alle Makros verarbeitet hat.

Jeder Versuch, ein Makro auszuführen oder Daten zu senden, bevor der DDE-Server die Ausführung des aktuellen Makros abgeschlossen hat, kann zum Fehlschlagen des aktuellen Makros oder zu unvorhersehbaren Ergebnissen führen. Weitere Informationen hierzu finden Sie in der Dokumentation des DDE-Servers.

Anmerkung:  Kann der Makrobefehl erfolgreich an den DDE-Server gesendet werden, gibt ExecuteMacro true zurück. Dieser Rückgabewert bedeutet aber nicht, das der Makrobefehl auf dem Server erfolgreich ausgeführt werden kann.

Siehe auch