DDE functions and events

The following tables list the DDE functions and events separated into those functions and events used by DDE clients and those used by DDE servers. For more information on DDE support, see the PowerScript Reference.

NoteReturn values Every DDE function returns an integer.

DDE client

Table 18-1: DDE client functions

Function

Action

CloseChannel

Closes a channel to a DDE server application that was opened using OpenChannel.

ExecRemote

Asks a DDE server application to execute a command.

GetDataDDE

Obtains the new data from a hot-linked DDE server application and moves it into a specified string.

GetDataDDEOrigin

Determines the origin of data that has arrived from a hot-linked DDE server application.

GetRemote

Asks a DDE server application for data. This function has two formats: one that uses a channel and one that does not.

OpenChannel

Opens a DDE channel to a specified DDE server application.

RespondRemote

Indicates to the DDE server application whether the command or data received from the DDE application was acceptable to the DDE client.

SetRemote

Asks a DDE server application to set an item such as a cell in a worksheet or a variable to a specific value. This function has two formats: one that uses a DDE channel and one that does not.

StartHotLink

Initiates a hot link to a DDE server application so that PowerBuilder is immediately notified of specific data changes in the DDE server application.

StopHotLink

Ends a hot link with a DDE server application.

Table 18-2: DDE client event

Event

Occurs when

HotLinkAlarm

A DDE server application has sent new (changed) data.

DDE server

Table 18-3: DDE server functions

Function

Action

GetCommandDDE

Obtains the command sent by a DDE client application

GetCommandDDEOrigin

Determines the origin of a command from a DDE client

GetDataDDE

Gets data that a DDE client application has sent and moves it into a specified string

GetDataDDEOrigin

Determines the origin of data that has arrived from a hot-linked DDE client application

RespondRemote

Indicates to the sending DDE client application whether the command or data received from the DDE application was acceptable to the DDE server

SetDataDDE

Sends specified data to a DDE client application

StartServerDDE

Causes a PowerBuilder application to begin acting as a DDE server

StopServerDDE

Causes a PowerBuilder application to stop acting as a DDE server

Table 18-4: DDE server events

Event

Occurs when

RemoteExec

A DDE client application has sent a command

RemoteHotLinkStart

A DDE client application wants to start a hot link

RemoteHotLinkStop

A DDE client application wants to end a hot link

RemoteRequest

A DDE client application has requested data

RemoteSend

A DDE client application has sent data