Progress
Language Reference


DDE TERMINATE Statement

Interfaces
OS
SpeedScript
All
Windows only
No

Closes the specified dynamic data exchange (DDE) conversation.

SYNTAX

DDE TERMINATE ddeid [ NO-ERROR ] 

ddeid

An integer expression that equals the channel number of an open conversation. It is the value returned by the DDE INITIATE statement that opened the conversation.

NO-ERROR

By default, if the statement fails to close the conversation, it sets the Progress error condition, and posts the error to the DDE frame DDE-ERROR attribute. If you specify NO-ERROR, the statement does not set the Progress error condition but does post the error to the DDE frame.

EXAMPLE

The following fragment shows a typical use of the DDE TERMINATE statement. It assumes that the Microsoft Excel application is running, and has created the default Excel worksheet, Sheet1. It then uses the DDE INITIATE statement to open a conversation with Sheet1 as the topic, returning the channel number of the conversation to the variable, Sheet1. After exchanging data with the worksheet, the example closes the conversation with Sheet1 using the DDE TERMINATE statement.

DEFINE VARIABLE Sheet1 AS INTEGER.        /* DDE-ID to worksheet topic */
DEFINE VARIABLE DDEframe AS WIDGET-HANDLE./* DDE frame handle          */

CREATE FRAME DDEframe.                    /* Create DDE frame.         */
                       .
                       .
                       .
/* Open a DDE conversation with "Sheet1" and assign column headings. */

DDE INITIATE Sheet1 FRAME DDEframe APPLICATION "Excel" TOPIC "Sheet1".
DDE SEND Sheet1 SOURCE "Name"      ITEM "R1C1".
DDE SEND Sheet1 SOURCE "YTD Sales" ITEM "R1C2".
DDE SEND Sheet1 SOURCE "State"     ITEM "R1C3".
                       .
                       .
                       .
DDE TERMINATE Sheet1. 

NOTES

SEE ALSO

DDE ADVISE Statement, DDE INITIATE Statement


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095