### IDDEEvent

  IDDEEvent is the base class for most Dynamic Data Exchange (DDE) event classes.

  An object of this class, or one of its derived classes, is created when an IDDEClientConversation object or IDDETopicServer object needs to pass information to the client or server application. You do not construct objects of this class.

### IDDEEvent - 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 IDDETopicServer or IDDEClientConversation objects.

~IDDEEvent

      public:
      ~IDDEEvent()

Supported Platforms

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

IDDEEvent

  Overload 1

      public:
      IDDEEvent(const IDDEEvent& ddeEvent)

Supported Platforms

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

  Overload 2

      public:
      IDDEEvent(const IEvent& ddeEvent)

Supported Platforms

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

### Event Information

Use these members to query information about the item and format of the data that the event is dealing with.

format

      public:
      IString format() const

  Returns the name of the format.

Supported Platforms

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

item

      public:
      IString item() const

  Returns the name of the item.

Supported Platforms

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

### Implementation

Derived classes use these members to set and obtain the attributes of this class.

buffer

      protected:
      IString buffer() const

  Returns the data buffer.
  Note: The IDDEEvent::buffer 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

setBuffer

      protected:
      IDDEEvent& setBuffer(IString dataBuffer)

  Sets the data into the data buffer.

Supported Platforms

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

setStatus

      protected:
      IDDEEvent& setStatus(unsigned short status)

  Sets the status field of the event.

Supported Platforms

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

status

      protected:
      unsigned short status() const

  Returns the status of the event.

Supported Platforms

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

### IDDEEvent - Inherited Member Functions and Data

#### Inherited Public Functions

  IEvent

  -     virtual ~IEvent()

  -     IWindowHandle controlHandle() const

  -     virtual IWindow* controlWindow() const

  -     IEvent& decrementOwnerLevels()

  -     virtual IWindow* dispatchingWindow() const

  -     unsigned long eventId() const

  -     IWindowHandle handle() const

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

  -     IEvent(const IEvent& event)

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

  -     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

  - None

#### Inherited Protected Data

  - None