UIElement.ManipulationStarting 事件

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

在首次创建操作处理器时发生。

public:
 event EventHandler<System::Windows::Input::ManipulationStartingEventArgs ^> ^ ManipulationStarting;

public event EventHandler<System.Windows.Input.ManipulationStartingEventArgs> ManipulationStarting;

member this.ManipulationStarting : EventHandler<System.Windows.Input.ManipulationStartingEventArgs> 

Public Custom Event ManipulationStarting As EventHandler(Of ManipulationStartingEventArgs) 

事件类型

EventHandler<ManipulationStartingEventArgs>

示例

以下示例演示 事件的事件处理程序 ManipulationStarting ，并将 设置为 ManipulationContainer 接收操作事件的父元素，以便操作的坐标相对于父元素。 此示例是 演练：创建第一个触摸应用程序中较大示例的一部分。

void Window_ManipulationStarting(object sender, ManipulationStartingEventArgs e)
{
    e.ManipulationContainer = this;
    e.Handled = true;
}

Private Sub Window_ManipulationStarting(ByVal sender As Object, ByVal e As ManipulationStartingEventArgs)
    e.ManipulationContainer = Me
    e.Handled = True
End Sub

注解

当用户 ManipulationStarting 将手指放在该元素上时， IsManipulationEnabled 该事件发生在属性设置为 true 的 元素上。 默认情况下，后续操作事件报告操作相对于设置为 true的IsManipulationEnabled元素的位置。 可以通过设置 ManipulationContainer 属性来指定位置应相对于另一个元素。 例如，可以相对于 元素的父级进行操作。

还可以在 的事件处理程序 ManipulationStarting中执行以下操作：

• 通过设置 ManipulationStartingEventArgs.IsSingleTouchEnabled 属性，指定用户是否需要多个手指来执行操作。

• 通过将 属性设置为 ManipulationStartingEventArgs.Mode 枚举来 ManipulationModes 指定启用的操作类型。

• 通过设置 ManipulationStartingEventArgs.Pivot 属性指定单指旋转的中心。

• 通过调用 ManipulationStartingEventArgs.Cancel 方法取消操作。

有关操作的详细信息，请参阅 输入概述。 有关响应操作的应用程序的示例，请参阅 演练：创建第一个触控应用程序。

路由事件信息

标识符字段	ManipulationStartingEvent
路由策略	鼓 泡
委托	EventHandler<TEventArgs>类型ManipulationStartingEventArgs。