Vcl.DdeMan.TDdeClientConv.PokeDataLines

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

bool __fastcall PokeDataLines(const System::UnicodeString Item, System::Classes::TStrings* Data);

Properties

Type Visibility Source Unit Parent
function public
Vcl.DdeMan.pas
Vcl.DdeMan.hpp
Vcl.DdeMan TDdeClientConv

Description

Sends multiple lines of data to a DDE server application.

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.

See Also