UIElement.IsManipulationEnabled Property

Definition

Ruft einen Wert ab, der angibt, ob Manipulationsereignisse in dieser UIElement-Klasse aktiviert werden, oder legt ihn fest.Gets or sets a value that indicates whether manipulation events are enabled on this UIElement.

public:
 property bool IsManipulationEnabled { bool get(); void set(bool value); };
public bool IsManipulationEnabled { get; set; }
member this.IsManipulationEnabled : bool with get, set
Public Property IsManipulationEnabled As Boolean

Property Value

Boolean

true, wenn Manipulationsereignisse in dieser UIElement-Klasse aktiviert werden, andernfalls false.true if manipulation events are enabled on this UIElement; otherwise, false. Der Standardwert lautet false.The default is false.

Examples

Im folgenden Beispiel wird eine Anwendung erstellt, die über ein rotes Rechteck verfügt.The following example creates an application that has a red Rectangle. Die IsManipulationEnabled-Eigenschaft des Rechtecks ist auf true festgelegt, und das Fenster der Anwendung abonniert die Ereignisse ManipulationStarting, ManipulationDeltaund ManipulationInertiaStarting.The IsManipulationEnabled property of the Rectangle is set to true and the application's window subscribes to the ManipulationStarting, ManipulationDelta, and ManipulationInertiaStarting events. Dieses Beispiel ist Teil eines größeren Beispiels in Exemplarische Vorgehensweise : Erstellen Ihrer ersten Touchscreen-Anwendung.This example is part of a larger example in Walkthrough: Creating Your First Touch Application.

<Window x:Class="BasicManipulation.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="Move, Size, and Rotate the Square"
        WindowState="Maximized"
        ManipulationStarting="Window_ManipulationStarting"
        ManipulationDelta="Window_ManipulationDelta"
        ManipulationInertiaStarting="Window_InertiaStarting">
  <Window.Resources>

    <!--The movement, rotation, and size of the Rectangle is 
        specified by its RenderTransform.-->
    <MatrixTransform x:Key="InitialMatrixTransform">
      <MatrixTransform.Matrix>
        <Matrix OffsetX="200" OffsetY="200"/>
      </MatrixTransform.Matrix>
    </MatrixTransform>

  </Window.Resources>

  <Canvas>
    <Rectangle Fill="Red" Name="manRect"
                 Width="200" Height="200" 
                 RenderTransform="{StaticResource InitialMatrixTransform}"
                 IsManipulationEnabled="true" />
  </Canvas>
</Window>

Remarks

Legen Sie diese Eigenschaft auf true fest, wenn das UIElement die Ereignisse ManipulationStarting, ManipulationStarted, ManipulationDelta, ManipulationInertiaStarting, ManipulationBoundaryFeedbackund ManipulationCompleted empfangen soll.Set this property to true if you want the UIElement to receive the ManipulationStarting, ManipulationStarted, ManipulationDelta, ManipulationInertiaStarting, ManipulationBoundaryFeedback, and ManipulationCompleted events. Weitere Informationen zu Manipulationen finden Sie unter Übersicht über die Eingabe.For more information about manipulations, see the Input Overview. Ein Beispiel für eine Anwendung, die auf Manipulationen antwortet, finden Sie unter Exemplarische Vorgehensweise : Erstellen der ersten Fingereingabe Anwendung.For an example of an application that responds to manipulations, see Walkthrough: Creating Your First Touch Application.

Applies to