UIElement.ManipulationMode プロパティ

定義

名前空間:

Windows.UI.Xaml

UIElement の動作とジェスチャとの対話に使用される ManipulationModes 値を取得または設定します。 この値を設定すると、アプリ コードでこの要素からの操作イベントを処理できます。

public:
 property ManipulationModes ManipulationMode { ManipulationModes get(); void set(ManipulationModes value); };

ManipulationModes ManipulationMode();

void ManipulationMode(ManipulationModes value);

public ManipulationModes ManipulationMode { get; set; }

var manipulationModes = uIElement.manipulationMode;
uIElement.manipulationMode = manipulationModes;

Public Property ManipulationMode As ManipulationModes

<uiElement ManipulationMode="All"/>
-or-
<uiElement ManipulationMode="None"/>
-or-
<uiElement ManipulationMode="singleManipulationModesMemberName"/>
-or-
<uiElement ManipulationMode="relatedManipulationModesNames"/>

プロパティ値

ManipulationModes

列挙体の値または値。 既定値は通常 System ですが、これは特定のコントロールと要素によって異なる場合があります。 「解説」を参照してください。

注釈

アプリ コードの UI 要素から ManipulationStarted などの操作イベントを処理する場合は、ManipulationMode を System または None 以外の値に設定する必要があります。 操作の詳細については、「 ポインター入力を処理する」を参照してください。

ManipulationMode の一般的な既定値は、None ではなく System です。 値が System の場合、要素から派生した操作は、直接操作 API に基づくWindows ランタイム インフラストラクチャによって処理できます。 たとえば、 ScrollViewer はコントロール ロジックでユーザー操作を処理し、コントロールのスクロール アクションとして処理します。 System 値を使用すると、操作イベントに応答するパーソナリティ アニメーションも有効になります。

Slider と ToggleSwitch には、ManipulationMode 値を None に設定する既定の テンプレートがあるため、 None はデザイン時に表示される既定値になります。

関連する操作モードの指定

複数のフラグごとの ManipulationModes 値を ManipulationMode プロパティの値として指定できます。 これは、"XAML 値" セクションに示されているコンマ構文を使用して XAML で可能です。 たとえば、 TranslateX、 TranslateY、 Rotate、 Scale、またはこれらの任意の組み合わせを組み合わせることができます。 ただし、すべての組み合わせが有効なわけではありません。 Validity は、特定のコントロールで ManipulationModes が使用された後にのみ適用されるため、 ManipulationModes の無効な組み合わせを設定する際の問題は、値が適用される実行時まで表示されない可能性があります。

• Translate* 値と TranslateRails* 値を組み合わせないでください。これらは相互に排他的な値として扱われます。
• 慣性値と非慣性値を組み合わせないでください。
• All 値は、すべてのフラグの実際の加算値ではありません (値がビット単位で比較される場合)。 All の値は、すべての値の組み合わせが有効であるか、特定の値が設定されていることを必ずしも示すわけではありません。

以前のバージョンの注意事項

Windows 8.x Windows 8では、ManipulationMode を System と他の値を組み合わせた値に設定すると例外がスローされるため、上記の組み合わせの一部はWindows 8では機能しません。 Windows 8.1以降、System と他の値を組み合わせることができます。

Windows 8用にコンパイルされたが、Windows 8.1で実行されているアプリは、新しい動作を使用し、System と他の値の組み合わせを許可します。

こちらもご覧ください

• ManipulationStarted
• ManipulationDelta
• ManipulationCompleted
• ManipulationModes
• ポインター入力の処理
• 直接操作リファレンス
• 基本的な入力サンプル (Windows 10)