### IDDEDataEvent

  The IDDEDataEvent class provides event information and data to a client application.

  An object of this class is created when an IDDEClientConversation object needs to pass data sent from a server to the client application. This can result from a requestData request or from an active hot link. You do not construct objects of this class.

### IDDEDataEvent - Member Functions and Data by Group

### Constructors & Destructor

You can construct and destruct objects of this class, although normally you never need to do so. These events are usually created and deleted for you by IDDEClientConversation objects.

~IDDEDataEvent

      public:
      ~IDDEDataEvent()

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

IDDEDataEvent

      public:
      IDDEDataEvent(const IEvent& ddeEvent)

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

### Event Information

Use these members to query the data and other related information from the event.

data

      public:
      IString data() const

  Returns the data provided by the server.
  Note: The IDDEDataEvent::data member's IString is constructed from a void* and length. For character strings, if the terminating NULL is included in the length, it is in the buffer. Before performing string operations, such as concatenation, on this string, use IString::stripTrailing to strip any trailing NULL character.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

isAckRequested

      public:
      bool isAckRequested() const

  Returns true if the server has requested an acknowledgment of receipt of the data. The IDDEClientConversation object automatically sends the acknowledgment when it is requested.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

isDataFromHotLink

      public:
      bool isDataFromHotLink() const

  Returns true if the data is being sent as the result of an active hot link. Returns false if the data is sent in response to an IDDEClientConversation::requestData call.

Supported Platforms

  Windows | OS/2 | AIX
  Yes | Yes | No

### IDDEDataEvent - Inherited Member Functions and Data

#### Inherited Public Functions

  IDDEEvent

  -     ~IDDEEvent()

  -     IString format() const

  -     IDDEEvent(const IDDEEvent& ddeEvent)

  -     IDDEEvent(const IEvent& ddeEvent)

  -     IString item() const

  IDDESetAcknowledgeInfoEvent

  -     ~IDDESetAcknowledgeInfoEvent()

  -     IDDESetAcknowledgeInfoEvent( const IDDESetAcknowledgeInfoEvent& ddeEvent )

  -     IDDESetAcknowledgeInfoEvent(const IEvent& ddeEvent)

  -     IDDESetAcknowledgeInfoEvent& setApplicationBusy()

  -     IDDESetAcknowledgeInfoEvent&
          setApplicationSpecificData( unsigned char applicationData )

  -     IDDESetAcknowledgeInfoEvent& setMessageNotUnderstood()

  IEvent

  -     virtual ~IEvent()

  -     IWindowHandle controlHandle() const

  -     virtual IWindow* controlWindow() const

  -     IEvent& decrementOwnerLevels()

  -     virtual IWindow* dispatchingWindow() const

  -     unsigned long eventId() const

  -     IWindowHandle handle() const

  -     IEvent( const IWindowHandle& handle,
                unsigned long eventId,
                const IEventParameter1& parameter1,
                const IEventParameter2& parameter2 )

  -     IEvent( IWindow* window,
                unsigned long eventId,
                const IEventParameter1& parameter1,
                const IEventParameter2& parameter2 )

  -     IEvent(const IEvent& event)

  -     IEvent& operator =(const IEvent& event)

  -     IEventParameter1 parameter1() const

  -     IEventParameter2 parameter2() const

  -     bool passToOwner() const

  -     IEventResult result() const

  -     IEvent& setControlHandle(const IWindowHandle& handle)

  -     IEvent& setDispatchingHandle(const IWindowHandle& handle)

  -     IEvent& setDispatchingWindow(IWindow* window)

  -     IEvent& setHandle(const IWindowHandle& handle)

  -     IEvent& setNumberOfLevels(int levels = - 1)

  -     IEvent& setPassToOwner(bool passOn = true)

  -     IEvent& setResult(bool eventResult)

  -     IEvent& setResult(const IEventResult& eventResult)

  -     virtual IWindow* window() const

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  IDDEEvent

  -     IString buffer() const

  -     IDDEEvent& setBuffer(IString dataBuffer)

  -     IDDEEvent& setStatus(unsigned short status)

  -     unsigned short status() const

#### Inherited Protected Data

  - None