UIElement.ManipulationMode Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение ManipulationModes , используемое для поведения UIElement и взаимодействия с жестами. Установка этого значения позволяет обрабатывать события манипуляции из этого элемента в коде приложения.
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"/>
Значение свойства
Значение или значения перечисления. По умолчанию обычно используется system, но это может отличаться в зависимости от конкретных элементов управления и элементов. См. заметки.
Комментарии
Если вы хотите обрабатывать события манипуляции, такие как ManipulationStarted, из элементов пользовательского интерфейса в коде приложения необходимо задать значение, отличное от System или None. Дополнительные сведения о манипуляциях см. в разделе Обработка входных данных указателя.
Типичное значение по умолчанию ManipulationMode — System , а не None. Если значение равно System, манипуляции, происходящие из элемента, могут обрабатываться инфраструктурой среда выполнения Windows, основанной на API прямых манипуляций. Например, ScrollViewer обрабатывает пользовательские манипуляции в своей логике элемента управления и обрабатывает их как действия прокрутки для элемента управления. Значение System также включает анимацию личности, которая реагирует на события манипуляции.
Ползунок и Переключатель имеют шаблоны по умолчанию, которые задают для значения ManipulationMode значение Нет, поэтому Значение None будет отображаться по умолчанию во время разработки.
Указание связанных режимов манипуляции
В качестве значения свойства ManipulationMode можно указать несколько значений по флагу ManipulationModes . Это возможно в XAML с помощью синтаксиса запятой, показанного в разделе "Значения XAML". Например, можно сочетать TranslateX, TranslateY, Rotate и Scale или любое их сочетание. Однако не все сочетания являются допустимыми. Допустимость применяется только после того, как 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 с другими значениями.