PointerPressed Event

Occurs when the pointer device initiates a Press action within the specific control.

Namespace: C1.Win.TouchToolKit

Assembly: C1.Win.TouchToolKit.4.8.dll

Syntax

public event EventHandler<PointerEventArgs> PointerPressed

Public Event PointerPressed As EventHandler(Of PointerEventArgs)

Returns

Type	Description
EventHandler<PointerEventArgs>	Occurs when the pointer device initiates a Press action within the specific control.

Remarks

Note Other events instead of PointerReleased may fire at the end of the action—for example, PointerCanceled or PointerCaptureLost. 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. Some of the reasons why you might not get a PointerReleased occurrence are:

Differences in how specific hardware handles touch actions and Press actions
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.

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

	public GcTouchEventProviderPointerDemo()
	{
		InitializeComponent();

		_gcTouchEventProvider.SetEnableTouchEvents(_bluePanel, true);

		_gcTouchEventProvider.PointerPressed += _gcTouchEventProvider_PointerPressed;
	}

	private void _gcTouchEventProvider_PointerPressed(object sender, PointerEventArgs e)
	{
		string log = "Target: " + e.TargetControl.Name + " Event: PointerPressed" + "  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);

		_messageListBox = new ListBox();
		_messageListBox.Size = new Size(750, 310);
		_messageListBox.Location = new Point(20, 240);

		this.Controls.Add(_bluePanel);
		this.Controls.Add(_messageListBox);
	}
}

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

	Public Sub New()
		InitializeComponent()

		_gcTouchEventProvider.SetEnableTouchEvents(_bluePanel, True)

		AddHandler _gcTouchEventProvider.PointerPressed, AddressOf _gcTouchEventProvider_PointerPressed
	End Sub

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

		_messageListBox = New ListBox()
		_messageListBox.Size = New Size(750, 310)
		_messageListBox.Location = New Point(20, 240)

		Me.Controls.Add(_bluePanel)
		Me.Controls.Add(_messageListBox)
	End Sub
End Class