IDMSourceBeginEvent

The IDMSourceBeginEvent class represents the event that is generated by the start of a direct manipulation at the source. Objects of this class are created by the source handler and passed as parameters to functions that participate in the handling of this event.


IDMSourceBeginEvent - Member Functions and Data by Group

Constructors & Destructor

You can construct and destruct objects of this class.


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

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


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

Constructs objects of this class from a generic IEvent object.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Container Support

Use these members to query information about a container control that is the source of a direct manipulation.


[view class]
container
public:
virtual IContainerControl* container() const

Returns a pointer to the source container from which the source begin event occurred.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


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

Returns the source container's identifier (ID).

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
object
public:
virtual IContainerObject* object() const

Returns a pointer to the object over which the drag started. If the drag started over the container's white space or if the window is not a container, 0 is returned.
Note: The white space of a container is an area that no container objects occupy.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
offset
public:
virtual ISize offset() const

Returns the position of the hot spot of the pointing device relative to the source container object's origin.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


Event Information

Use these members to query event information for this class.


[view class]
position
public:
virtual IPoint position() const

Returns the position of the hot spot of the pointing device.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes


[view class]
source
public:
virtual Source source() const

Returns the source of the direct manipulation.

Supported Platforms

Windows OS/2 AIX
Yes Yes Yes

OS/2 Considerations

The source of the direct manipulation is always IDM::pointingDevice.


IDMSourceBeginEvent - Inherited Member Functions and Data

Inherited Public Functions

IDMEvent
IEvent

Inherited Public Data

Inherited Protected Functions

Inherited Protected Data