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.


[view class]
~IDDEDataEvent
public:
~IDDEDataEvent()

Supported Platforms

Windows OS/2 AIX
Yes Yes No


[view class]
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.


[view class]
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


[view class]
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


[view class]
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
IDDESetAcknowledgeInfoEvent
IEvent

Inherited Public Data

Inherited Protected Functions

IDDEEvent

Inherited Protected Data