### IDDEClientHotLinkEvent

  The IDDEClientHotLinkEvent class provides information to a client application when a change notification for a hot link item is sent by a server application.

  An object of this class is created when an IDDEClientConversation object needs to pass a hot link notification to the client application. An object of this class for each active hot link is also kept in a set by IDDEClientConversation objects to keep track of active hot links. You do not construct objects of this class.

### IDDEClientHotLinkEvent - 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 IDDEClientConversationt objects.

~IDDEClientHotLinkEvent

      public:
      ~IDDEClientHotLinkEvent()

Supported Platforms

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

IDDEClientHotLinkEvent

  Overload 1

      public:
      IDDEClientHotLinkEvent( const IDDEClientHotLinkEvent& ddeEvent )

Supported Platforms

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

  Overload 2

      public:
      IDDEClientHotLinkEvent(const IEvent& ddeEvent)

Supported Platforms

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

### Event Information

Use these members to query information about the hot link event.

isAckRequested

      public:
      bool isAckRequested() const

  Returns true if the server has requested an acknowledgment of receipt of the notification. TheIDDEClientConversation object automatically sends the acknowledgment when it is requested.

Supported Platforms

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

isDataRequested

      public:
      bool isDataRequested() const

  Returns true if the hot link is a data hot link. False is returned if it is a notification hot link. This function is only pertinent for objects of this class used to keep track of active hot links (contained in an IDDEClientHotLinkSet object). All other objects of this class are created for notifications sent by non-data hot links.

Supported Platforms

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

### IDDEClientHotLinkEvent - 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