ManipulationStartingEventArgs.Pivot プロパティ


シングルポイント操作のピボットを記述するオブジェクトを取得または設定します。Gets or sets an object that describes the pivot for a single-point manipulation.

 property System::Windows::Input::ManipulationPivot ^ Pivot { System::Windows::Input::ManipulationPivot ^ get(); void set(System::Windows::Input::ManipulationPivot ^ value); };
public System.Windows.Input.ManipulationPivot Pivot { get; set; }
member this.Pivot : System.Windows.Input.ManipulationPivot with get, set
Public Property Pivot As ManipulationPivot



シングルポイント操作のピボットを記述するオブジェクト。An object that describes the pivot for a single-point manipulation.

次の例では、ManipulationStarting イベントのイベントハンドラーを示し、ManipulationStartingEventArgs.Pivot プロパティを設定します。The following example shows an event handler for the ManipulationStarting event and sets the ManipulationStartingEventArgs.Pivot property. この例をテストするには、「チュートリアル: 初めてのタッチアプリケーションの作成」の手順に従って、手順 4. のコードをこのコードで置き換えます。To test this example, follow the steps in Walkthrough: Creating Your First Touch Application and replace the code in step 4 with this code.

void Window_ManipulationStarting(object sender, ManipulationStartingEventArgs e)
    // Set the ManipulationPivot so that the element rotates as it is
    // moved with one finger.
    FrameworkElement element = e.OriginalSource as FrameworkElement;
    ManipulationPivot pivot = new ManipulationPivot();
    pivot.Center = new Point(element.ActualWidth / 2, element.ActualHeight / 2);
    pivot.Radius = 20;
    e.Pivot = pivot;

    e.ManipulationContainer = this;
    e.Handled = true;
Private Sub Window_ManipulationStarting(ByVal sender As Object, ByVal e As ManipulationStartingEventArgs)
    ' Set the ManipulationPivot so that the element rotates as it is
    ' moved with one finger.
    Dim element As FrameworkElement = TryCast(e.OriginalSource, FrameworkElement)
    Dim pivot As New ManipulationPivot()
    pivot.Center = New Point(element.ActualWidth / 2, element.ActualHeight / 2)
    pivot.Radius = 20
    e.Pivot = pivot

    e.ManipulationContainer = Me
    e.Handled = True
End Sub


Pivot プロパティを設定すると、操作中にユーザーが1本の指を使用したときに、操作に回転データが格納されます。When you set the Pivot property, the manipulation will contain rotation data when the user uses one finger during a manipulation. これは、1本の指を使用して、テーブル上の紙などのオブジェクトを回転できる実際の状況をシミュレートするためのものです。This is to simulate real-world situations where you can use one finger to rotate an object, such as a piece of paper on a table. Pivotnull場合は、2本の指を使用して回転させる必要があります。If the Pivot is null, the user must use two fingers to cause rotation.

操作の詳細については、「入力の概要」を参照してください。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.