DdeCommand

obj -> DdeCommand(int1, int2[, alpha3]) : int

DDE-Befehl absetzen

Details

• obj: Deskriptor des DDE-Kanals
• int1:
  • Funktionstyp:
  • _DdeReceive
  • _DdeSend
  • _DdeExecute
  • _DdeAdviseOn
  • _DdeAdviseOff
• int2: Maximale Wartezeit
• alpha3: Elementname bzw. optionales Kommando
• Resultat: int Fehlerwert
• Siehe: Verwandte Befehle , DdeConnect ()

Mit dieser Funktion wird ein DDE-Befehl an die DDE-Applikation geschickt. In (obj) steht der Deskriptor des DDE-Kanals. In (int1) wird der Funktionstyp übergeben:

• _DdeReceive - Themeninhalt abrufen Bei diesem Funktionstyp wird in (alpha3) der Elementname des mit DdeConnect () gewählten Themas angegeben. Die Information kann nach erfolgreicher Ausführung mit DdeGetData () aus dem Empfangs-Puffer ausgelesen werden.
• _DdeSend - Information übetragen Mit diesem Funktionstyp wird die Information aus dem Sendepuffer an die Applikation übertragen. In (alpha3) steht in diesem Fall das Element, in welches eingefügt werden soll (dabei kann es sich zum Beispiel um eine Textmarkierung handeln).
• _DdeExecute - Kommando ausführen Mit diesem Funktionstyp wird das Kommando in (alpha3) ausgeführt. Wird (alpha3) nicht angegeben, so wird das im Sendepuffer enthaltene Kommando ausgeführt (zum Beispiel lange Makroanweisungen).
• _DdeAdviseOn - Aktualisierungsnachrichten einschalten Mit dieser Funktion wird der DDE-Server beauftragt, bei jeder Datenänderung des Elements (alpha3) automatisch eine Nachricht zu versenden. Ist der DDE-Kanal für ein Fenster-Objekt geöffnet worden, wird beim Eintreffen einer Nachricht das Ereignis EvtAdviseDDE des Fenster-Objektes aufgerufen. Ist der DDE-Kanal an die textorientierte Oberfläche von CONZEPT 16 gebunden, gibt der Befehl den Wert einer Funktionstaste zurück, die beim Eintreffen einer Aktualisierungsnachricht generiert wird (Damit der Funktionstastenwert auch verarbeitet werden kann, muss er gegebenfalls per 'SetIoFKey' aktiviert werden).

info

Die Funktionstaste kann nur in der textbasierten Oberfläche ausgewertet werden.

• _DdeAdviseOff - Aktualisierungsnachrichten ausschalten Mit dieser Funktion wird der DDE-Server beauftragt, bei Datenänderungen des Elements (alpha3) keine Nachricht mehr zu versenden.

Im Argument (int2) kann eine maximale Wartezeit in Millisekunden angegeben werden. Wird die Wartezeit zu klein gewählt, kann als Resultat der Funktion -1 zurückgeliefert werden, obwohl der Befehl erfolgreich ausgeführt wurde. Bei erfolgreicher Ausführung des Befehls wird als Ergebnis Null zurückgeliefert.

Mögliche Laufzeitfehler:

• _ErrHdlInvalid: Deskriptor ungültig