TDdeClientConv.PokeDataLines Method

Sends multiple lines of data to a DDE server application.

Pascal

function PokeDataLines(const Item: string; Data: TStrings): Boolean;

C++

__fastcall Boolean PokeDataLines(const AnsiString Item, TStrings Data);

Description

Use PokeDataLines to transfer multiple lines of text data to a DDE server that supports poked data. Item specifies the linked item in the DDE server. Data is a set of strings that specifies the text data to transfer.

The value of the DDE item depends on the linked DDE server application. Item is typically a selectable portion of text, such as a spreadsheet cell or a database field in an edit box.

The usual direction of data flow is from the DDE server to the DDE client application. Some DDE server applications won't accept poked data. PokeData returns true if the data was successfully transferred, false if the data was not successfully transferred.

To poke a single string rather than a string list, use the PokeData method.

Note: If either the ExecuteMacro or ExecuteMacroLines method was called with its WaitFlg parameter set to true, PokeData will automatically fail until the server application has completed executing the macro. The WaitStat property indicates when PokeData will attempt to poke data to the server.