展开 最小化

UIElement.ManipulationMode Property

获取或设置用于带有笔势的 UIElement 行为和交互的 ManipulationModes 值。

语法


public ManipulationModes ManipulationMode { get; set; }


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


XAML Values

singleManipulationModesMemberName

约束对单个行为的操作的 ManipulationModes 枚举的命名常量之一,例如 TranslateX

relatedManipulationModesNames

由逗号分隔的两个或多个 ManipulationModes 枚举常量名称,例如 TranslateX,TranslateY。请参阅“指定相关处理模式”部分。

属性值

类型: ManipulationModes

枚举的一个值。默认值通常是 System,但根据特定控件和元素可能会有所不同。请参见“备注”。

备注

如果要处理操作事件(例如从您应用程序代码中 UI 元素的 ManipulationStarted),则必须将 ManipulationMode 设置为其他值,而不是 SystemNone。有关操作的更多信息,请参见快速入门:触控输入

ManipulationMode 的典型默认值为 System 而不是 None。该值为 System 时,源自该元素的操作可以由根据 直接操作API 的 Windows 运行时基础结构处理。例如,ScrollViewer 按其控件逻辑处理用户操作,并将它们作为控件的滚动事件处理。System 值还可启用响应操作事件的个性动画。

SliderToggleSwitch 具有默认模板,将 ManipulationMode 值设置为 None,因此,None 将是在设计时所看到的默认值。

指定相关的操作模式

你可以在代码或 XAML 中使用所示的逗号语法将多个按标志的 ManipulationModes 值指定为 ManipulationMode 属性的值。例如,可以合并 TranslateXTranslateYRotateScale,或者它们的任意组合。但是,并非所有组合都有效。仅当特定控件使用 ManipulationModes 后,才会强制实施有效性,因此设置存在的问题(ManipulationModes 的无效组合)不到运行时可能不会出现。不要合并 Translate* 值与 TranslateRails* 值,因为它们被视为独占值,不合并惯性值与非惯性值。All 值不是所有标志的实际附加值,因此,All 不一定表示所有值的组合有效,或已设置任何特定值。

在 Windows 8 上,如果将 ManipulationMode 设置为一个将 System 与其他值组合的值,将会引发异常。从 Windows 8.1 开始,你可以将 System 与其他值结合使用。

要求

最低支持客户端

Windows 8

最低支持服务器

Windows Server 2012

命名空间

Windows.UI.Xaml
Windows::UI::Xaml [C++]

元数据

Windows.winmd

另请参见

UIElement
ManipulationStarted
ManipulationDelta
ManipulationCompleted
ManipulationModes
快速入门:触控输入
直接操作引用

 

 

显示:
© 2014 Microsoft