UIElement.TryStartDirectManipulation(Pointer) Метод

Определение

Возобновляет обработку прямых манипуляций (сдвига и масштабирования, определяемых системой) в любом родительском элементе ScrollViewer , содержающем текущий элемент UIElement.

public:
 static bool TryStartDirectManipulation(Pointer ^ value);
 static bool TryStartDirectManipulation(Pointer const& value);
public static bool TryStartDirectManipulation(Pointer value);
function tryStartDirectManipulation(value)
Public Shared Function TryStartDirectManipulation (value As Pointer) As Boolean

Параметры

value
Pointer

Активная точка касания, которая инициировала манипуляцию.

Возвращаемое значение

Boolean

bool

Значение true , если родительский элемент ScrollViewer существует, и установка значения приводит к возобновлению действия сдвига или масштабирования. Значение false , если вызов метода не приводит к действию.

Комментарии

По умолчанию взаимодействие сенсорного ввода в элементах ScrollViewer обрабатывается обработчиком прямых операций вне потока пользовательского интерфейса. Приложение не может напрямую обрабатывать связанные события указателя после запуска обработки direct manipulation . Вы можете вызывать CancelDirectManipulations в начале взаимодействия ScrollViewer и обрабатывать события указателя в потоке пользовательского интерфейса, что дает возможность выполнять пользовательскую обработку ввода в ScrollViewer.

Если отменить обработку прямых манипуляций в начале взаимодействия ScrollViewer , можно вызвать TryStartDirectManipulation, чтобы возобновить обработку входного потока с помощью direct manipulation . Это позволяет сначала выполнять пользовательскую обработку ввода, а затем возобновлять обработку прямых операций , чтобы сделать приложение более чувствительным к сенсорным взаимодействиям, таким как прокрутка и масштабирование.

В direct Manipulation можно передавать только активные сенсорные контакты. Использование неактивных или не сенсорных контактов приводит к возникновению исключения.

При указании сенсорного контакта, передаваемого в direct Manipulation , платформа проходит вверх по родительской цепочке и устанавливает контакт в окне просмотра Direct Manipulation каждого объекта ScrollViewer , обнаруженного в указанном порядке, до тех пор, пока прогулка не достигнет любого элемента (включая исходный целевой элемент), который не имеет ManipulationMode , содержащего ManipulationModes.System. Данный сенсорный контакт может быть связан только с одной цепочкой визуальных элементов одновременно. Вызов TryStartDirectManipulation несколько раз в одном контакте приводит к освобождению любой предыдущей цепочки.

Применяется к

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