UIElement.ManipulationMode Свойство

Определение

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

Microsoft.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, но он может отличаться в зависимости от конкретных элементов управления и элементов. См. заметки.

Комментарии

Необходимо задать ManipulationMode для параметра значение, отличное System от или None , если вы хотите обрабатывать события манипуляции, такие как ManipulationStarted из элементов пользовательского интерфейса в коде приложения. Дополнительные сведения о манипуляциях см. в разделе Обработка входных данных указателя.

Типичное значение ManipulationMode по умолчанию — , System а не None. Если значение равно System, манипуляции, происходящие из элемента, могут обрабатываться инфраструктурой среда выполнения Windows, основанной на API прямой манипуляции. Например, ScrollViewer обрабатывает манипуляции пользователей в логике элемента управления и обрабатывает их как действия прокрутки для элемента управления. Это System значение также включает анимации личности, которые реагируют на события манипуляции.

Slider и ToggleSwitch имеют шаблоны по умолчанию, которые устанавливают для значения ManipulationMode значение None, поэтому None это будет значение по умолчанию, которое отображается во время разработки.

Указание связанных режимов манипуляции

В качестве значения свойства можно указать несколько флаговых значений ManipulationModeManipulationModes. Это возможно в XAML с помощью синтаксиса запятой, показанного в разделе "Значения XAML". Например, можно объединить TranslateX, TranslateY, Rotateи Scaleили любое их сочетание. Однако допустимы не все сочетания. Допустимость применяется только один раз ManipulationModes , когда используется определенным элементом управления, поэтому проблемы с заданием недопустимого ManipulationModes сочетания могут не возникать до тех пор, пока не будут применены значения во время выполнения.

• Не объединяйте значения Translate* со значениями TranslateRails*, они рассматриваются как взаимоисключающие значения.
• Не объединяйте инерционные значения с неинерционными значениями.
• Значение All не является истинным аддитивным значением всех флагов (если значения сравниваются по битовой). Значение All не обязательно указывает, что сочетание всех значений является допустимым или что задано какое-либо конкретное значение.

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

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