### IDMSourceDiscardEvent

  The IDMSourceDiscardEvent class represents objects that have been dropped on a shredder object. Objects of this class are constructed by the source handler, IDMSourceHandler.

  Objects of this class return an indicator to the shredder object, which identifies what has the responsibility for the deletion of the items or which indicates that the discard operation is to be aborted.

#### AIX Considerations

  This event is not supported on AIX.

#### OS/2 Considerations

  Objects of this class wrapper the DM_DISCARDOBJECT message.

#### Windows Considerations

  This event is not supported on Windows.

### IDMSourceDiscardEvent - Member Functions and Data by Group

### Constructors & Destructor

You can construct and destruct objects of this class.

~IDMSourceDiscardEvent

      public:
      virtual ~IDMSourceDiscardEvent()

Supported Platforms

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

IDMSourceDiscardEvent

      public:
      IDMSourceDiscardEvent(const IEvent& event)

  Constructs objects of this class from a generic IEvent object.

Supported Platforms

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

### Event Information

Use these members to set and query event information for this class.

setSourceOperation

      public:
      IDMSourceDiscardEvent&
        setSourceOperation( const IDMSourceOperation::Handle& operation )

  Sets the handle of the drag source operation for this event.

Supported Platforms

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

setWhoDiscards

      public:
      IDMSourceDiscardEvent&
        setWhoDiscards( DiscardIndicator indicator )

  Sets the discard indicator, which identifies the following:

  - The source discards the item. This is the default.

    This is usually accomplished by calling IDMItem::sourceDiscard for the drag item.

  - The target discards the item.

    The target is usually the shredder object. Let it discard the object only if the object is a file; otherwise, it does not recognize how to discard your application objects.

  - The discard is aborted.

Supported Platforms

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

sourceOperation

      public:
      IDMSourceOperation::Handle sourceOperation() const

  Returns the handle of the drag source operation for this event.

Supported Platforms

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

whoDiscards

      public:
      virtual DiscardIndicator whoDiscards() const

  Returns the discard indicator identifying what should delete the drag items.

Supported Platforms

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

### IDMSourceDiscardEvent - 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( IWindow* window,
                unsigned long eventId,
                const IEventParameter1& parameter1,
                const IEventParameter2& parameter2 )

  -     IEvent( const IWindowHandle& handle,
                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(bool eventResult)

  -     IEvent& setResult(const IEventResult& eventResult)

  -     virtual IWindow* window() const

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  - None

#### Inherited Protected Data

  - None