UIElement.ManipulationMode Свойство

Определение

Пространство имен:

Windows.UI.Xaml

Возвращает или задает значение 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"/>

Значение свойства

ManipulationModes

Значение или значения перечисления. По умолчанию обычно используется 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 с другими значениями.

См. также раздел

• ManipulationStarted
• ManipulationDelta
• ManipulationCompleted
• ManipulationModes
• Работа с данными указателя
• Справочник по прямым манипуляциям
• Базовый пример входных данных (Windows 10)