UIElement.ManipulationStarting UIElement.ManipulationStarting UIElement.ManipulationStarting UIElement.ManipulationStarting Event

定義

操作プロセッサを初めて作成するときに発生します。Occurs when the manipulation processor is first created.

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) 

次の例では、 ManipulationStartingイベントのイベントハンドラーを示し、操作の座標が親要素に対して相対的になるように操作イベントを受け取る親要素ManipulationContainerにを設定します。The following example shows the event handler for the ManipulationStarting event and sets the ManipulationContainer to the parent element that receives the manipulation events so that the coordinates of the manipulation are relative to the parent element. この例は、 「チュートリアル:初めてのタッチアプリケーションの作成。This example is part of a larger example in Walkthrough: Creating Your First Touch Application.

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プロパティがに設定されている要素で発生します。The ManipulationStarting event occurs on an element that has the IsManipulationEnabled property set to true when the user puts a finger on it. 既定では、後続の操作イベントは、がにIsManipulationEnabled true設定されている要素に対する操作の相対的な位置を報告します。By default, subsequent manipulation events report the position of the manipulation relative to the element that has IsManipulationEnabled set to true. ManipulationContainerプロパティを設定することにより、別の要素に対して相対的な位置を指定することができます。You can specify that the position should be relative to another element by setting the ManipulationContainer property. たとえば、要素の親を基準として操作を行うことができます。For example, you can make the manipulation relative to the parent of the element.

ManipulationStartingイベントハンドラーでは、次の操作を行うこともできます。You can also do the following in an event handler for ManipulationStarting:

操作の詳細については、「入力の概要」を参照してください。For more information about manipulations, see the Input Overview. 操作に応答するアプリケーションの例については、 「チュートリアル:初めてのタッチアプリケーションの作成。For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

ルーティングされたイベント情報Routed Event Information

識別子フィールドIdentifier field ManipulationStartingEvent
ルーティング方法Routing strategy バブリングBubbling
DelegateDelegate EventHandler<TEventArgs> 型の ManipulationStartingEventArgsEventHandler<TEventArgs> of type ManipulationStartingEventArgs.

適用対象