Obtains the command sent by the client application when your application is a DDE server.
GetCommandDDE ( string )
Argument |
Description |
---|---|
string |
A string variable in which GetCommandDDE will store the command |
Integer. Returns 1 if it succeeds and -1 if an error occurs (such as the function was called in the wrong context). If string is null, GetCommandDDE returns null.
When a DDE client application sends a command to your application, the action triggers a RemoteExec event in the active window. In that event’s script, you call GetCommandDDE to find out what command has been sent. You decide how your application will respond to the command.
To enable DDE server mode, use the function StartServerDDE, in which you decide how your application will be known to other applications.
This excerpt from a script for the RemoteExec event checks to see if the action requested by the DDE client is Open Next Sheet. If it is, the DDE server opens another instance of the sheet DataSheet. If the requested action is Shut Down, the DDE server shuts itself down. Otherwise, it lets the DDE client know the requested action was invalid.
The variables ii_sheetnum and i_DataSheet[ ] are instance variables for the window that responds to the DDE event:
integer ii_sheetnum
DataSheet i_DataSheet[ ]
This script that follows uses the local variable ls_Action to store the command sent by the client application:
string ls_Action
GetCommandDDE(ls_Action)
IF ls_Action = "Open Next Sheet" THEN
ii_sheetnum = ii_sheetnum + 1
OpenSheet(i_DataSheet[ii_sheetnum], w_frame_emp)
ELSEIF ls_Action = "Shut Down" THEN
HALT CLOSE
ELSE
RespondRemote(FALSE)
END IF