Vcl.DdeMan.TDdeClientConv.ExecuteMacro
Delphi
function ExecuteMacro(Cmd: PAnsiChar; waitFlg: Boolean): Boolean;
C++
bool __fastcall ExecuteMacro(char * Cmd, bool waitFlg);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Vcl.DdeMan.pas Vcl.DdeMan.hpp |
Vcl.DdeMan | TDdeClientConv |
Description
Envoie une chaîne de macro-commande à l'application serveur DDE.
ExecuteMacro permet d'envoyer une macro-commande à l'application serveur. Pour en envoyer plusieurs, utilisez ExecuteMacroLines. ExecuteMacro renvoie true si la macro a pu être transmise avec succès à l'application serveur DDE. Si ExecuteMacro n'est pas parvenu à transmettre une chaîne de commande, ExecuteMacro renvoie false.
Cmd est une chaîne à zéro terminal contenant la macro à exécuter par l'application serveur DDE. La valeur réelle de Cmd dépend de l'application serveur DDE. Pour connaître les chaînes de commandes acceptées par une application serveur DDE, voir sa documentation.
WaitFlg détermine si ce client DDE doit attendre que l'application serveur DDE finisse d'exécuter la macro avant d'autoriser une autre transaction DDE. Si WaitFlg a la valeur true, les appels suivants à ExecuteMacro, ExecuteMacroLines, PokeData, PokeDataLines et RequestData échoueront jusqu'à ce que l'application serveur DDE ait fini d'exécuter la macro.
Toute tentative d'exécuter une macro ou de transmettre des données avant qu'une application serveur DDE ait fini d'exécuter la macro en cours peut provoquer l'échec de la macro en cours ou lui faire produire des résultats imprévisibles. Pour savoir ce qui se produira si vous transmettez des chaînes de commandes ou renvoyez des données avant la fin de l'exécution d'une macro, consultez la documentation de l'application serveur DDE.
Remarque : ExecuteMacro renvoie true si la macro-commande a été correctement transmise au serveur DDE. La valeur true ne garantit pas que la macro-commande s'exécutera avec succès quand elle aura été acceptée par le serveur.