The IDMTargetDropEvent class encapsulates a direct manipulation drop event when a user drops drag items onto a target. Objects of this class are constructed by the target handler, IDMTargetHandler. An object of this class is constructed once when the drop occurs.
Objects of this class provide information about the drag items from the static IDMTargetOperation object. The target operation object is created during the processing of the initial IDMTargetEnterEvent for a target.
You can construct and destruct objects of this class.
![]() |
public:
virtual ~IDMTargetDropEvent()
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
IDMTargetDropEvent(const IEvent& event)
Constructs objects of this class from a generic IEvent object.
IAccessError | The object for the target drop event was not created. The drag information is not accessible. |
Windows | OS/2 | AIX |
Yes | Yes | Yes |
Use these members to provide drop support for the container drop event.
![]() |
public:
virtual IContainerControl* container() const
Returns a pointer to the container where the drop occurred.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
virtual unsigned long containerId() const
Returns the target container's identifier (ID).
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
virtual IContainerObject* object() const
Returns a pointer to the object over which the drop occurred.
If the drop occurred over the container's white space
or the window is not a container, 0 is returned.
Note:
Windows | OS/2 | AIX |
Yes | Yes | Yes |
Use these members to set and query drop and target information.
![]() |
public:
virtual IPoint dropPosition() const
Returns the position where the drop occurred. This position is given in desktop coordinates (i.e., the origin (0,0) is the top left corner of the screen).
Windows | OS/2 | AIX |
Yes | Yes | Yes |
in OS/2, the origin is the bottom left corner of the screen.
![]() |
public:
virtual IDMTargetDropEvent& setDropPosition( const IPoint& position )
Sets the position where the drop occurred. This position is given in desktop coordinates (i.e., the origin (0,0) is the top left corner of the screen).
Windows | OS/2 | AIX |
Yes | Yes | Yes |
in OS/2, the origin is the bottom left corner of the screen.
![]() |
public:
virtual IDMTargetDropEvent& setTargetInfo( unsigned long info )
Sets information that is passed to the source renderer.
Windows | OS/2 | AIX |
Yes | Yes | Yes |
![]() |
public:
virtual unsigned long targetInfo() const
Returns the target-defined information.
Note:
Windows | OS/2 | AIX |
Yes | Yes | Yes |
virtual ~IDMEvent()
IDMEvent(const IEvent& event)
virtual ~IDMTargetEvent()
IDMTargetEvent(const IEvent& event)
virtual IPresSpaceHandle presSpace()
virtual void releasePresSpace()
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