PullGestureRecognizer

A gesture recognizer that tracks a pull gesture. A pull gesture occurs when a pointer is dragged from the edge of a control. The direction of the pull is defined by the PullDirection property.

Using a PullGestureRecognizer

A PullGestureRecognizer can be attached to a control using the control's GestureRecognizers property.

<Border Width="500"
        Height="500"
        Margin="5"
        Name="border">
  <Border.GestureRecognizers>
    <PullGestureRecognizer PullDirection="TopToBottom"/>
  </Border.GestureRecognizers>
</Border>

C#

border.GestureRecognizers.Add(new PullGestureRecognizer()
            {
                PullDirection = PullDirection.TopToBottom,
            });

The PullGestureRecognizer raises a Gestures.PullGestureEvent when it detects the start of a pull gesture. When the pull ends, from the pointer being released or another gesture start, it raises a Gestures.PullGestureEndedEvent.

PullDirection

This defines the direction of the pull. There are 4 available values;

• PullDirection.TopToBottom : Pull starts from the top edge and moves towards the buttom
• PullDirection.BottomToTop : Pull starts from the bottom edge and moves towards the top
• PullDirection.LeftToRight : Pull starts from the left edge and moves towards the right
• PullDirection.RightToLeft : Pull starts from the right edge and moves towards the left

Binding Events

After the PullGestureRecognizer has been added to your control, you need to bind them in your code behind either through an inline handler or to an event function:

C#

image.AddHandler(Gestures.PullGestureEvent, (s, e) => { });
image.AddHandler(Gestures.PullGestureEndedEvent, (s, e) => { });

C#

image.AddHandler(Gestures.PullGestureEvent, Image_PullGesture);
image.AddHandler(Gestures.PullGestureEndedEvent, Image_PullGestureEnded);
...
private void Image_PullGesture(object? sender, PullGestureEventArgs e) { }
private void Image_PullGestureEnded(object? sender, PullGestureEndedEventArgs e) { }

If your event handles the gesture completely, you can mark the event as handled by setting:

C#

e.Handled = true;

Useful Properties

You will probably use these properties most often:

Property	Description
PullDirection	Defines the direction of the pull gesture.

More Information

info

View the source code on GitHub

PullGestureRecognizer.cs

PullGestureEventArgs.cs