ComponentOne Basic Library for WPF and Silverlight
C1DragHelper Constructor


C1.Silverlight Namespace > C1DragHelper Class : C1DragHelper Constructor
An System.Windows.UIElement on which the drag gesture will be listened.
Indicates the sort of drag to be listened. Combine inertia flag with other flags so that DragDelta events are raised after the manipulation finish. i.e. C1DragHelperMode.FreeDrag | C1DragHelperMode.Inertia
Specifies the number of pixels the gesture will have to pass in order to start. if 0 is set the gesture will start on pointer down, and captureElementOnPointerPressed will be true despite the specified parameter, otherwise the gesture will start on mouse move, default value is 1
Indicates whether the element will be captured in pointer pressed event (MouseLeftButtonDown in SL and WPF and PointerPressed in WinRT) or in the first pointer move event (MouseMove in SL and WPF and PointerMoved in WinRT). If initialThreshold is 0 this parameter will be ignored.Capturing the element on mouse down will cause Click, DoubleClick and MouseLeftButtonUp events not to be fired in sub-elements (nested elements in the visual tree), whereas capturing the element on the first mouse move can make it difficult for final users to drag small elements quickly.
Indicates whether drag gestures will be listened despite mouse events were already handled. (It only applies to mouse gestures)
When set to true it uses Manipulation events to listen to the gesture, otherwise itwill use Pointer events.
if set to true it will listen to mouse right button down/up events instead of left button events(In WinRT it only applies if useManipulationEvents is set to false).
Initializes a new C1DragHelper.
Syntax
'Declaration
 
Public Function New( _
   ByVal element As System.Windows.UIElement, _
   Optional ByVal mode As C1DragHelperMode, _
   Optional ByVal initialThreshold As System.Double, _
   Optional ByVal captureElementOnPointerPressed As System.Boolean, _
   Optional ByVal handledEventsToo As System.Boolean, _
   Optional ByVal useManipulationEvents As System.Boolean, _
   Optional ByVal useRightButton As System.Boolean _
)
'Usage
 
Dim element As System.Windows.UIElement
Dim mode As C1DragHelperMode
Dim initialThreshold As System.Double
Dim captureElementOnPointerPressed As System.Boolean
Dim handledEventsToo As System.Boolean
Dim useManipulationEvents As System.Boolean
Dim useRightButton As System.Boolean
 
Dim instance As New C1DragHelper(element, mode, initialThreshold, captureElementOnPointerPressed, handledEventsToo, useManipulationEvents, useRightButton)
public C1DragHelper( 
   System.Windows.UIElement element,
   C1DragHelperMode mode,
   System.double initialThreshold,
   System.bool captureElementOnPointerPressed,
   System.bool handledEventsToo,
   System.bool useManipulationEvents,
   System.bool useRightButton
)

Parameters

element
An System.Windows.UIElement on which the drag gesture will be listened.
mode
Indicates the sort of drag to be listened. Combine inertia flag with other flags so that DragDelta events are raised after the manipulation finish. i.e. C1DragHelperMode.FreeDrag | C1DragHelperMode.Inertia
initialThreshold
Specifies the number of pixels the gesture will have to pass in order to start. if 0 is set the gesture will start on pointer down, and captureElementOnPointerPressed will be true despite the specified parameter, otherwise the gesture will start on mouse move, default value is 1
captureElementOnPointerPressed
Indicates whether the element will be captured in pointer pressed event (MouseLeftButtonDown in SL and WPF and PointerPressed in WinRT) or in the first pointer move event (MouseMove in SL and WPF and PointerMoved in WinRT). If initialThreshold is 0 this parameter will be ignored.Capturing the element on mouse down will cause Click, DoubleClick and MouseLeftButtonUp events not to be fired in sub-elements (nested elements in the visual tree), whereas capturing the element on the first mouse move can make it difficult for final users to drag small elements quickly.
handledEventsToo
Indicates whether drag gestures will be listened despite mouse events were already handled. (It only applies to mouse gestures)
useManipulationEvents
When set to true it uses Manipulation events to listen to the gesture, otherwise itwill use Pointer events.
useRightButton
if set to true it will listen to mouse right button down/up events instead of left button events(In WinRT it only applies if useManipulationEvents is set to false).
Remarks
Capturing the element on mouse down will cause Click, DoubleClick and MouseLeftButtonUp events not to be fired in sub-elements (nested elements in the visual tree), whereas capturing the element on the first mouse move can make it difficult for final users to drag small elements quickly.
See Also

Reference

C1DragHelper Class
C1DragHelper Members