WinUI | ComponentOne
C1.WinUI.Core Assembly / C1.WinUI.Core Namespace / C1DragHelper Class / C1DragHelper Constructor
An Microsoft.UI.Xaml.FrameworkElement 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 WINUI) or in the first pointer move event (MouseMove in SL and WPF and PointerMoved in WINUI). 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 it will use Pointer events.
if set to true it will listen to mouse right button down/up events instead of left button events(In WINUI it only applies if useManipulationEvents is set to false).
if set to true the drag action will be initiated by a hold operation .
In This Topic
    C1DragHelper Constructor
    In This Topic
    Initializes a new C1DragHelper.
    Syntax
    public C1DragHelper( 
   FrameworkElement element,
   C1DragHelperMode mode,
   Nullable<double> initialThreshold,
   bool captureElementOnPointerPressed,
   bool handledEventsToo,
   bool useManipulationEvents,
   bool useRightButton,
   bool startByHolding
)

    Parameters

    element
    An Microsoft.UI.Xaml.FrameworkElement 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 WINUI) or in the first pointer move event (MouseMove in SL and WPF and PointerMoved in WINUI). 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 it will use Pointer events.
    useRightButton
    if set to true it will listen to mouse right button down/up events instead of left button events(In WINUI it only applies if useManipulationEvents is set to false).
    startByHolding
    if set to true the drag action will be initiated by a hold operation .
    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