Release 10.1A: OpenEdge Development:
Programming Interfaces

> ## Defining conversation endpoints—DDE frames

> Progress uses named frames as client endpoints for DDE conversations. A DDE frame, in effect, owns the client end of a conversation. You specify the DDE frame for a conversation when you open it with the `DDE INITIATE` statement.

> A DDE frame can be visible or hidden during application execution. A hidden DDE frame effectively insulates the user from the conversation, preventing any unintended user intervention. However, the frame must be realized before you can open a conversation with it. That is, you must make it visible before hiding it (set the frame `VISIBLE` attribute = `TRUE`; then the `HIDDEN` attribute = `TRUE`).

> A DDE frame can be a client endpoint for more than one DDE conversation, and you can use multiple DDE frames to open multiple conversations with the same application and topic. Your decision to use one or more DDE frames depends entirely on how you decide to allocate frames for your application and distribute DDE conversations among them. Otherwise, it makes no difference whether you use one or many DDE frames for conversation endpoints.

> Each DDE frame provides a set of frame attributes that maintain the status of conversations owned by the frame. Table 13–2 lists these DDE frame attributes.

> Table 13–2: DDE frame attributes
> Attribute | Type | Readable | Setable
> --- | --- | --- | ---
>     DDE-ERROR
>     INTEGER
> | ÷ | –
>     DDE-ID
>     INTEGER
> | ÷ | –
>     DDE-ITEM
>     CHARACTER
> | ÷ | –
>     DDE-NAME
>     CHARACTER
> | ÷ | –
>     DDE-TOPIC
>     CHARACTER
> | ÷ | –

> Each time a conversational exchange occurs—that is, each time a DDE statement executes or Progress posts a `DDE-NOTIFY` event—Progress updates the DDE attributes of the frame that owns the conversation. These attributes are especially useful for determining the exact nature of a DDE run-time error (`DDE-ERROR`) and identifying the data item that triggered a `DDE-NOTIFY` event (`DDE-NAME`, `DDE-TOPIC`, and `DDE-ITEM`). (For more information on `DDE-NOTIFY` events, see the "Exchanging data in conversations" section.)

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