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