Skip to main content

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 bottom
  • 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:

PropertyDescription
PullDirectionDefines the direction of the pull gesture.

More Information​

info

View the source code on GitHub

PullGestureRecognizer.cs

PullGestureEventArgs.cs