C1.Win.TouchToolKit.C1TouchEventProvider.PointerCaptureLost

PointerCaptureLost Event

Occurs when pointer capture previously held by the specific control moves to another control or elsewhere.

Namespace: C1.Win.TouchToolKit

Assembly: C1.Win.TouchToolKit.8.dll

Syntax

public event EventHandler<PointerEventArgs> PointerCaptureLost

Returns

Type	Description
EventHandler<PointerEventArgs>	Occurs when pointer capture previously held by the specific control moves to another control or elsewhere.

Remarks

Note PointerCaptureLost 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 PointerCaptureLost.

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.PointerCaptureLost += _gcTouchEventProvider_PointerCaptureLost;
	}

	private void _gcTouchEventProvider_PointerCaptureLost(object sender, PointerEventArgs e)
	{
		string log = "Target: " + e.TargetControl.Name + " Event: PointerCaptureLost" + "  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.PointerCaptureLost, AddressOf _gcTouchEventProvider_PointerCaptureLost
	End Sub

	Private Sub _gcTouchEventProvider_PointerCaptureLost(sender As Object, e As PointerEventArgs)
		Dim log As String = "Target: " & Convert.ToString(e.TargetControl.Name) & " Event: PointerCaptureLost" & "  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