DDE

Concept Link IconSee also Concept Link IconExample

Communication control for DDE exchanges with a DDE server applications.

The third-party DDE server does not need to be configured in PcVue.

WebVue support - Yes.

Mode

Mnemonic

Syntax

1 INITIATE 1
2 TERMINATE 2
3 TERMINATEALL 3
4 TIMEOUT 4
5 EXECUTE 5
6 REQUEST 6
7 POKE 7

Syntax 1

LongVal = DDE (Mode, ServiceName, Topicname);

Return type: LONG.

Argument

Meaning

ServiceName

The name of the DDE server. Type STR

TopicName

The name of a DDE topic. Type STR

Execution

Mode

Mnemonic

Action

1

INITIATE

Start a DDE conversation with the named DDE server. The return contains a channel number identifying the conversation.

 

 

Return: 0 if error, else the channel number of the conversation.

Syntax 2

IntVal = DDE (Mode, Channel);

Return type: INTEGER.

Argument

Meaning

Channel

The channel number of a DDE conversation as returned by DDE INITIATE. Type LONG

Execution

Mode

Mnemonic

Action

2

TERMINATE

Terminate a DDE conversation identified by the channel number.

 

 

Return: 0 if error, else OK.

Syntax 3

IntVal = DDE (Mode);

Return type: INTEGER.

Execution

Mode

Mnemonic

Action

3

TERMINATEALL

Terminate all DDE conversations.

 

 

Return: 0 if error, else OK.

Syntax 4

IntVal = DDE (Mode, Channel, Timeout);

Return type: INTEGER.

Argument

Meaning

Channel

The channel number of a DDE conversation as returned by DDE initiate. Type LONG

Timeout

A period expressed in milliseconds. Type LONG

Execution

Mode

Mnemonic

Action

4

TIMEOUT

Modify the conversation timeout for the conversation identified by the channel number.

 

 

Return: 0 if error, else OK.

Syntax 5

IntVal = DDE (Mode, Channel, Command);

Return type: INTEGER.

Argument

Meaning

Channel

The channel number of a DDE conversation as returned by DDE initiate. Type LONG

Command

A string containing an instruction to be sent to the DDE server. Type STR

Execution

Mode

Mnemonic

Action

5

Execute

Request the execution of a command by the DDE server.

 

 

Return: 0 if error, else OK.

Syntax 6

IStrVal = DDE (Mode, Channel, ItemName);

Return type: STRING.

Argument

Meaning

Channel

The channel number of a DDE conversation as returned by DDE initiate. Type LONG

ItemName

A string containing the name of an item. Type STR

Execution

Mode

Mnemonic

Action

6

REQUEST

Request the value of a specific element of a conversation from a DDE server.

 

 

Return: The value of the element.

Syntax 7

IStrVal = DDE (Mode, Channel, ItemName, Data);

Return type: INTEGER.

Argument

Meaning

Channel

The channel number of a DDE conversation as returned by DDE initiate. Type LONG

ItemName

A string containing the name of an item. Type STR

Data

A string containing a new value for the item. Type STR

Execution

Mode

Mnemonic

Action

7

POKE

Write the value of a specific element of a conversation from a DDE server.

 

 

Return: 0 if error, else OK.

Example

For an example, select the Example link above.