UIElement.ManipulationMode プロパティ

  • リファレンス

定義

名前空間:
Microsoft.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 ですが、これは特定のコントロールと要素によって異なる場合があります。 「解説」を参照してください。

注釈

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

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

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

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

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

適用対象

こちらもご覧ください