Pointer 类

定义

命名空间:

Windows.UI.Xaml.Input

为与单个鼠标、笔/触笔或触摸接触关联的输入指针提供基本属性。

public ref class Pointer sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class Pointer final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class Pointer

Public NotInheritable Class Pointer

继承

Object Platform::Object IInspectable Pointer

属性

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

下面的代码示例演示了使用 Pointer 类查找应用中每个输入触点的唯一 PointerId ，使用 PointerDeviceType 忽略特定形式的输入 (例如，鼠标输入) 并存储指针位置。 有关使用 Pointer 类的其他代码，请参阅 输入示例。

using System.Collections.Generic;
using Windows.Foundation;
using Windows.UI.Xaml.Controls;
using Windows.UI.Xaml.Input;
using Windows.UI.Xaml.Navigation;

namespace PointerExample
{
    public sealed partial class BlankPage : Page
    {
        Dictionary<uint, Point?> _contacts;
        const uint SUPPORTEDCONTACTS = 5;

        public BlankPage()
        {
            this.InitializeComponent();
            _contacts = new Dictionary<uint, Point?>((int)SUPPORTEDCONTACTS);
            this.PointerPressed += BlankPage_PointerPressed;
            this.PointerReleased += BlankPage_PointerReleased;
        }

        private void BlankPage_PointerPressed(object sender, 
            PointerRoutedEventArgs e)
        {
            // Ignore mouse inputs. 
            if (e.Pointer.PointerDeviceType != 
                Windows.Devices.Input.PointerDeviceType.Mouse)
            {
                // Store and touch input contacts.  
                Windows.UI.Input.PointerPoint pt = e.GetCurrentPoint(this);
                _contacts[e.Pointer.PointerId] = pt.Position;
            }
            e.Handled = true;
        }

        private void BlankPage_PointerReleased(object sender, 
            PointerRoutedEventArgs e)
        {
            // Ignore mouse inputs.
            if (e.Pointer.PointerDeviceType != 
                Windows.Devices.Input.PointerDeviceType.Mouse)
            {
                // Remove pointer contacts information.
                uint ptrId = e.Pointer.PointerId;
                if (_contacts.ContainsKey(ptrId))
                {
                    _contacts[ptrId] = null;
                    _contacts.Remove(ptrId);
                }
            }
            e.Handled = true;
        }
    }
}

注解

在大多数情况下，我们建议你通过所选语言框架中的指针事件处理程序的事件参数获取指针信息， (使用 JavaScript 的 Windows 应用、使用 C++、C# 或 Visual Basic 的 UWP 应用，或使用 DirectX 和 C++) 的 UWP 应用。

如果事件参数未在本质上公开应用所需的指针详细信息，则可以通过 PointerRoutedEventArgs 的 GetCurrentPoint 和 GetIntermediatePoints 方法访问扩展指针数据。 建议使用这些方法，因为可以指定指针数据的上下文。

静态 PointerPoint 方法 GetCurrentPoint 和 GetIntermediatePoints 始终使用应用的上下文。 指针是用于描述输入设备的抽象类。 此类标识每个指针事件的输入设备 (，例如触笔、手指或鼠标) 。

属性

IsInContact	获取一个值，该值确定在报告事件时指针设备是否与传感器或数字化器接触。
IsInRange	获取一个值，该值指示指针设备是否在传感器或数字化器的检测范围内。
PointerDeviceType	获取 指针设备的 PointerDeviceType 。
PointerId	获取此指针引用的系统生成的标识符。

另请参阅

• 输入示例