ddepoke (MATLAB Application Program Interface)

Send data from MATLAB to DDE server application

Syntax

rc = ddepoke(channel, item, data, format, timeout)

Arguments

rc

The return code: 0 indicates the function call failed, 1 indicates it succeeded.

channel

The channel assigned to the conversation, returned by ddeinit.

item

A string that specifies the DDE item for the data sent. item is the server data entity that is to contain the data sent in the data argument.

data

A matrix that contains the data to be sent.

format

(optional) A scalar that specifies the Windows clipboard format of the data. MATLAB supports only Text format, which corresponds to a value of 1.

timeout

(optional) A scalar that specifies the time-out limit for this operation. timeout is specified in milliseconds (1000 milliseconds = 1 second). The default timeout is three seconds.

Description

ddepoke sends data to an application via an established DDE conversation. ddepoke formats the data matrix as follows before sending it to the server application:

String matrices are converted, element by element, to characters and the resulting character buffer is sent.
Numeric matrices are sent as tab-delimited columns and carriage-return, line-feed delimited rows of numbers. Only the real part of non-sparse matrices are sent.

Example

% Send a 5-by-5 identity matrix to Excel.
rc = ddepoke(channel, 'r1c1:r5c5', eye(5));

[ Previous | Help Desk | Next ]