PointerCanceled Event

Occurs when a pointer that made contact abnormally loses contact.

Namespace: C1.Win.TouchToolKit

Assembly: C1.Win.TouchToolKit.10.dll

Syntax

public event EventHandler<PointerEventArgs> PointerCanceled

Public Event PointerCanceled As EventHandler(Of PointerEventArgs)

Returns

Type	Description
EventHandler<PointerEventArgs>	Occurs when a pointer that made contact abnormally loses contact.

Remarks

Note PointerCanceled might fire instead of PointerReleased. Don't rely on PointerPressed and PointerReleased events always occurring in pairs. To function properly, your app must listen for and handle all events that represent likely conclusions to the Press action, and that includes PointerCanceled. Some of the reasons why you might get a PointerCanceled occurrence are:

User actions that change the relationship of the display area, such as changing resolution or monitor settings
Input interactions such as a stylus touching the same surface as a previous touch action

This event is a routed event. If you do not want parent control receive this event, set PointerEventArgs.Handled

Examples

The following code example shows how to use this event.

This code example is part of a larger example provided for the PointerPressed event.

public class GcTouchEventProviderPointerDemo : Form
{
	private Panel _bluePanel;
	private GcTouchEventProvider _gcTouchEventProvider = new GcTouchEventProvider();

	public GcTouchEventProviderPointerDemo()
	{
		InitializeComponent();

		_gcTouchEventProvider.SetEnableTouchEvents(_bluePanel, true);

		_gcTouchEventProvider.PointerCanceled += _gcTouchEventProvider_PointerCanceled;
	}

	private void _gcTouchEventProvider_PointerCanceled(object sender, PointerEventArgs e)
	{
		string log = "Target: " + e.TargetControl.Name + " Event: PointerCanceled" + "  X: " + e.Position.X.ToString() + " Y: " + e.Position.Y.ToString();
		_messageListBox.Items.Add(log);
	}

	private void InitializeComponent()
	{
		_bluePanel = new Panel();
		_bluePanel.Name = "Blue";
		_bluePanel.BackColor = Color.Blue;
		_bluePanel.Size = new Size(200, 200);
		_bluePanel.Location = new Point(20, 20);
		this.Controls.Add(_bluePanel);
	}
}

Public Class GcTouchEventProviderPointerDemo
	Inherits Form
	Private _bluePanel As Panel
	Private _gcTouchEventProvider As New GcTouchEventProvider()

	Public Sub New()
		InitializeComponent()

		_gcTouchEventProvider.SetEnableTouchEvents(_bluePanel, True)

		AddHandler _gcTouchEventProvider.PointerCanceled, AddressOf _gcTouchEventProvider_PointerCanceled
	End Sub

	Private Sub _gcTouchEventProvider_PointerCanceled(sender As Object, e As PointerEventArgs)
		Dim log As String = "Target: " & Convert.ToString(e.TargetControl.Name) & " Event: PointerCanceled" & "  X: " & e.Position.X.ToString() & " Y: " & e.Position.Y.ToString()
		_messageListBox.Items.Add(log)
	End Sub

	Private Sub InitializeComponent()
		_bluePanel = New Panel()
		_bluePanel.Name = "Blue"
		_bluePanel.BackColor = Color.Blue
		_bluePanel.Size = New Size(200, 200)
		_bluePanel.Location = New Point(20, 20)
		Me.Controls.Add(_bluePanel)
	End Sub
End Class