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，但這可能會因特定控制項和元素而異。 請參閱＜備註＞。

備註

如果您想要處理來自應用程式程式碼中 UI 元素的 ManipulationStarted之類的操作事件， System 則必須將 設定 ManipulationMode 為 以外的 None 值。 如需操作的詳細資訊，請參閱 處理指標輸入。

的一般預設值 ManipulationMode 是 System ，而不是 None 。 當值為 System 時，源自 專案的操作可由以直接操作API 為基礎的Windows 執行階段基礎結構處理。 例如， ScrollViewer 會在其控制項邏輯中處理使用者操作，並將其處理為控制項的捲動動作。 這個 System 值也會啟用可回應操作事件的特質動畫。

Slider 和 ToggleSwitch 的預設範本會將 ManipulationMode 值設定為 None ，因此 None 會是您在設計階段看到的預設值。

您可以將多個旗標 操作模式 值指定為 屬性的值 ManipulationMode 。 這可以在 XAML 中使用「XAML 值」區段中所示的逗號語法來達成。 例如，您可以結合 TranslateX 、 TranslateY 、 Rotate 和 Scale ，或這些的任意組合。 不過，並非所有組合都是有效的。 只有在特定控制項使用一次 ManipulationModes 時，才會強制執行有效性，因此在套用值時，設定 無效組合 ManipulationModes 的問題可能不會顯示。

  • 請勿將 Translate* 值與 TranslateRails* 值結合，這些值會被視為互斥值。
  • 請勿將慣性值與非慣性值結合。
  • 如果值的位) 比較， 則 All 值不是所有旗標 (真正的加總值。 All的值不一定表示所有值的組合有效，或是已設定任何特定值。

適用於

另請參閱