IDMTargetEndEvent

The IDMTargetEndEvent class represents objects that the source sends to the target when the source renderer completes the rendering of a drag item. Objects of this class are constructed by the target handler, IDMTargetHandler. An object of this class is constructed for each drag item when a source renderer completes rendering.

Objects of this class provide source information about the drag item's rendering results.
Note: The Open Class Library does not process this event in any of its default rendering mechanisms and formats.


IDMTargetEndEvent - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class.


[view class]
~IDMTargetEndEvent
public:
virtual ~IDMTargetEndEvent()

Supported Platforms

Windows OS/2 AIX
Ignored Yes Ignored


[view class]
IDMTargetEndEvent
public:
IDMTargetEndEvent(const IEvent& event)

Constructs objects of this class from a generic IEvent object.

Exception

IInvalidRequest The object for the target end event was not created. The drag transfer information may be invalid.
IInvalidRequest The object for the target end event was not created. The drag item may be invalid.

Supported Platforms

Windows OS/2 AIX
Ignored Yes Ignored


Alternate Window

Use these members to query the alternate source window. For example, the alternate source window can be used to implement source rendering on a secondary thread.


[view class]
alternateWindow
public:
virtual IWindow* alternateWindow() const

Returns a pointer to the alternate source window object.

Supported Platforms

Windows OS/2 AIX
Ignored Yes Ignored


[view class]
alternateWindowHandle
public:
virtual IWindowHandle alternateWindowHandle() const

Returns the handle of the alternate source window object.

Supported Platforms

Windows OS/2 AIX
Ignored Yes Ignored


Rendering

Use these members to provide the rendering results returned by the source.


[view class]
dragItem
public:
virtual IDMItem::Handle dragItem() const

Returns the handle of the drag item that the source has completed rendering.

Supported Platforms

Windows OS/2 AIX
Ignored Yes Ignored


[view class]
renderingFailed
public:
bool renderingFailed() const

Returns true if the source cannot perform the rendering operation. The target can accept a retry attempt, but if the target is not prepared to retry, it must call IDMTargetRenderer::informSourceOfCompletion to end the direct manipulation.

Supported Platforms

Windows OS/2 AIX
Ignored Yes Ignored


[view class]
targetCanRetry
public:
bool targetCanRetry() const

Returns true if the target can retry its part of a failed rendering. The source has successfully completed its part of the rendering. The default is false.

Supported Platforms

Windows OS/2 AIX
Ignored Yes Ignored


[view class]
targetInfo
public:
virtual unsigned long targetInfo() const

Returns the target-defined information.
Note: This is an extra member the source and target can use to pass additional information to each other. You can use it to implement the specialized behavior for user-defined rendering mechanisms and formats.

Supported Platforms

Windows OS/2 AIX
Ignored Yes Ignored


IDMTargetEndEvent - Inherited Member Functions and Data

Inherited Public Functions

IDMEvent
IEvent

Inherited Public Data

Inherited Protected Functions

Inherited Protected Data