CoreInkIndependentInputSource 类

定义

提供属性、方法和事件,用于在 InkPresenter 对象处理之前处理指针输入。

重要

这些事件发生在墨迹后台线程上。 出于此原因,请确保墨迹输入的任何自定义处理尽可能轻量,以避免性能下降,并尽可能使应用保持响应。

public ref class CoreInkIndependentInputSource sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreInkIndependentInputSource final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreInkIndependentInputSource
Public NotInheritable Class CoreInkIndependentInputSource
继承
Object Platform::Object IInspectable CoreInkIndependentInputSource
属性

Windows 要求

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

注解

标准 Windows.UI.Input.墨迹书写 事件在墨迹笔划呈现后发生。

使用 Windows.UI.Input.Inking.Core 指针事件可截获原始指针数据,并在笔划的任何点取消或取消墨迹呈现。 在保护现有墨迹笔划或提供自定义手势支持(如长按)时,此功能非常有用,而无需创建墨迹项目。

(各种设备的输入(包括触摸、笔和鼠标) )作为指针输入接收、处理和管理。 来自任何这些设备的用户交互都可能生成以下事件。 有关详细信息,请参阅 处理指针输入

属性

InkPresenter

获取 InkPresenter 对象,该对象管理墨迹笔划数据的输入、处理和呈现。

PointerCursor

获取或设置墨迹书写时使用的指针光标。

方法

Create(InkPresenter)

检索 CoreInkIndependentInputSource 对象,以便在 InkPresenter 对象处理之前处理指针输入。

事件

PointerEntering

当检测到指针进入与 InkPresenter 对象关联的 InkCanvas 的命中测试或边界区域时发生。

PointerExiting

当检测到指针离开与 InkPresenter 对象关联的 InkCanvas 的命中测试或边界区域时发生。

PointerHovering

当指针在与 InkPresenter 对象关联的 InkCanvas 的命中测试或边界区域上检测到,但不向下或接触时发生。

PointerLost

在与 InkPresenter 对象关联的 InkCanvas 的命中测试或边界区域中或上方不再检测到指针时发生。

通常,如果触点移动到 InkCanvas 控件之外,或者该接触被另一个元素捕获,指针将丢失。

PointerMoving

当指针在与 InkPresenter 对象关联的 InkCanvas 的命中测试或边界区域内移动时发生。

PointerPressing

当指针在与 InkPresenter 对象关联的 InkCanvas 的命中测试或边界区域中注册接触时发生。 这可以是按下鼠标按钮或数字化器表面被手指或笔触摸时。

PointerReleasing

当与 PointerPressing 事件关联的指针在与 InkPresenter 对象关联的 InkCanvas 的命中测试或边界范围内时,可能会发生。

PointerReleasing 不保证与 PointerPressing 协同发生,因为 PointerLostPointerExiting 可能会改为发生。 应处理可以结束 PointerPressing 的所有事件。

PointerReleasing 可能不会发生的原因包括:

  • 特定硬件处理输入方式的差异
  • 从其他指针捕获编程指针
  • 更改显示区域关系的用户操作,例如更改分辨率或监视器设置
  • 输入交互,例如触笔,触摸上一个触摸操作的同一表面

适用于

另请参阅