@DDEPoke (Formula Language)

Deposits unsolicited data into the specified location within the DDE server application. If the data was successfully inserted into the target location, @DDEPoke returns an ACK (acknowledgement) with the value @True(1); if the attempt was not successful, the call returns a NACK (negative acknowledgment) with the value @False(0). If the conversation ID is invalid, an error is returned (see @IsError).

Note: DDEPoke is not supported by UNIX or on the Macintosh.

Syntax

@DDEPoke( conversationID ; location ; data )

Parameters

conversationID

The conversationID is returned by @DDEInitiate.

location

Text. The name of the location where you want to place the data. The location must be a cell, range, or field name; enclose it in quotation marks.

data

Text. Optional. The data you want to place at location. If you want to pass the contents of a non-text field, use @Text to convert it to text first. If data is a text list, only the first value in the list gets passed. If you omit data, Domino® passes the contents of the Windows Clipboard to the receiving application. If you supply the data as a parameter, either enclose it in quotation marks or specify a Domino® field name.

Usage

It is intended for use primarily in field formulas, agents, and toolbar buttons. Since the Macintosh does not support DDE, these commands will not work on Macintosh workstations. This function does not work in column or selection formulas, and is not intended for use in window title or form formulas.

If the user's NOTES.INi file includes the statement

NoExternalApps=1

then any formula involving @DDE functions is disabled. The user doesn't see an error message; the formula fails to execute.

You cannot use this function in Web applications.

Examples

See @DDEExecute.