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

~IDMSourceBeginEvent

      public:
      virtual ~IDMSourceBeginEvent()

Supported Platforms

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

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.

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

containerId

      public:
      virtual unsigned long containerId() const

  Returns the source container's identifier (ID).

Supported Platforms

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

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

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.

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

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

  -     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(bool eventResult)

  -     IEvent& setResult(const IEventResult& eventResult)

  -     virtual IWindow* window() const

#### Inherited Public Data

  - None

#### Inherited Protected Functions

  - None

#### Inherited Protected Data

  - None