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:
You can construct and destruct objects of this class.
![]() |
public:
virtual ~IDMTargetEndEvent()
Windows | OS/2 | AIX |
Ignored | Yes | Ignored |
![]() |
public:
IDMTargetEndEvent(const IEvent& event)
Constructs objects of this class from a generic IEvent object.
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. |
Windows | OS/2 | AIX |
Ignored | Yes | Ignored |
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.
![]() |
public:
virtual IWindow* alternateWindow() const
Returns a pointer to the alternate source window object.
Windows | OS/2 | AIX |
Ignored | Yes | Ignored |
![]() |
public:
virtual IWindowHandle alternateWindowHandle() const
Returns the handle of the alternate source window object.
Windows | OS/2 | AIX |
Ignored | Yes | Ignored |
Use these members to provide the rendering results returned by the source.
![]() |
public:
virtual IDMItem::Handle dragItem() const
Returns the handle of the drag item that the source has completed rendering.
Windows | OS/2 | AIX |
Ignored | Yes | Ignored |
![]() |
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.
Windows | OS/2 | AIX |
Ignored | Yes | Ignored |
![]() |
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.
Windows | OS/2 | AIX |
Ignored | Yes | Ignored |
![]() |
public:
virtual unsigned long targetInfo() const
Returns the target-defined information.
Note:
Windows | OS/2 | AIX |
Ignored | Yes | Ignored |
virtual ~IDMEvent()
IDMEvent(const IEvent& event)
virtual ~IEvent()
IWindowHandle controlHandle() const
virtual IWindow* controlWindow() const
IEvent& decrementOwnerLevels()
virtual IWindow* dispatchingWindow() const
unsigned long eventId() const
IWindowHandle handle() const
IEvent(const IEvent& event)
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& 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(const IEventResult& eventResult)
IEvent& setResult(bool eventResult)
virtual IWindow* window() const