DDESend (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Limit
External languages

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DDE functions

DDESend (Function)

In french: DDEEnvoie

Sends a data to the program connected via DDE.

Example

MyConnection = DDEConnect("Excel", Subject) // Connection
Counter = 3 // Repeats 3 times if necessary
LOOP // Sends the data
IF DDESend(MyConnection, Item, Data, 10) = True THEN BREAK
Counter --
IF Counter = 0 THEN
Error("The information was not sent to Excel")
BREAK
END
END
DDEDisconnect(MyConnection) // Disconnection

Syntax

<Result> = DDESend(<Connection identifier> , <Object for Sending> , <Data> [, <Timeout>])

<Result>: Boolean

True if the sending was performed,
False if an error occurred (DDEError returns the details of the error).

<Connection identifier>: Integer

Connection identifier, returned by DDEConnect.

<Object for Sending>: Character string

Object for sending to the program.

<Data>: Character string

Data that must be sent to the connected program.

<Timeout>: Optional integer or optional Duration

Maximum wait duration (in seconds). If the command was not run:
If <Timeout> is specified, there is a delay of <Timeout> seconds before exiting DDESend.
If <Timeout> is not specified, there is an endless wait.
Remark: This parameter can correspond to:
an integer corresponding to the number of seconds,
a Duration variable,
Versions 23 and later
the duration in clear ('1s' for example).
New in version 23
the duration in clear ('1s' for example).
the duration in clear ('1s' for example).

Remarks

Limit

The maximum size of all the parameters used by DDESend cannot exceed 1000 characters.

External languages

In the interface of WINDEV with the external languages, "Send"is equivalent to DDESend. All the parameters must be specified. The syntax is as follows:

in C: CALLDDE("Send,Recipient,Subject,Info")
in Windows Turbo Pascal: CALLDDE("Send,Recipient,Subject,Info")
in Windows Visual Basic: call CALLDDE("Send,Recipient,Subject,Info")

A maximum number of characters is allowed for each parameter:

Recipient: 8 characters
Subject: 30 characters
Info: 100 characters

Component: wd270std.dll