Vcl.DdeMan.TDdeClientConv.PokeData

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function PokeData(const Item: string; Data: PAnsiChar): Boolean;

C++

bool __fastcall PokeData(const System::UnicodeString Item, char * Data);

Eigenschaften

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

Beschreibung

Sendet Daten an einen DDE-Server.

Mit PokeData können Sie Textdaten an einen DDE-Server senden. Item gibt den verknüpften Eintrag im DDE-Server an. Data ist ein nullterminierter String, der die Textdaten enthält.

Der Wert von Item ist von der Server-Anwendung abhängig. Normalerweise handelt es sich um einen auswählbaren Textabschnitt wie beispielsweise eine Zelle in einem Arbeitsblatt oder ein Datenbankfeld in einem Eingabefeld. Ist der Server eine Delphi C++Builder-Anwendung, gibt Item den Namen der DDE-Server-Komponente an.

Normalerweise verläuft der Datenfluss vom DDE-Server zum DDE-Client. Manche DDE-Server akzeptieren jedoch keine Poke-Daten. Bei Erfolg gibt PokeData den Wert true zurück. Können die Daten nicht gesendet werden, wird false zurückgegeben.

Soll eine Stringliste anstelle eines einzelnen Strings gesendet werden, verwenden Sie die Methode PokeDataLines.

Anmerkung:  Wird die Methode ExecuteMacro oder ExecuteMacroLines mit auf true gesetztem Parameter WaitFlg aufgerufen, schlägt PokeData automatisch fehl, wenn der Server die Ausführung des aktuellen Makros noch nicht abgeschlossen hat. Die Eigenschaft WaitStat gibt an, wann PokeData versucht, Daten an den Server zu senden.

Siehe auch