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

~IDMTargetEndEvent

      public:
      virtual ~IDMTargetEndEvent()

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

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.

alternateWindow

      public:
      virtual IWindow* alternateWindow() const

  Returns a pointer to the alternate source window object.

Supported Platforms

  Windows | OS/2 | AIX
  Ignored | Yes | Ignored

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.

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

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

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

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

  -     virtual ~IDMEvent()

  -     IDMEvent(const IEvent& event)

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

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  - None

#### Inherited Protected Data

  - None