UIElement.ManipulationStarting Событие

Определение

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

System.Windows

Сборка:

PresentationCore.dll

Происходит при первоначальном создании процессора манипулирования.

public:
 event EventHandler<System::Windows::Input::ManipulationStartingEventArgs ^> ^ ManipulationStarting;

public event EventHandler<System.Windows.Input.ManipulationStartingEventArgs> ManipulationStarting;

member this.ManipulationStarting : EventHandler<System.Windows.Input.ManipulationStartingEventArgs> 

Public Custom Event ManipulationStarting As EventHandler(Of ManipulationStartingEventArgs) 

Тип события

EventHandler<ManipulationStartingEventArgs>

Примеры

В следующем примере показан обработчик событий для ManipulationStarting события и задан ManipulationContainer родительский элемент, получающий события манипуляции, чтобы координаты манипуляции были относительны от родительского элемента. Этот пример является частью более крупного примера в разделе Пошаговое руководство. Создание первого сенсорного приложения.

void Window_ManipulationStarting(object sender, ManipulationStartingEventArgs e)
{
    e.ManipulationContainer = this;
    e.Handled = true;
}

Private Sub Window_ManipulationStarting(ByVal sender As Object, ByVal e As ManipulationStartingEventArgs)
    e.ManipulationContainer = Me
    e.Handled = True
End Sub

Комментарии

Событие ManipulationStarting возникает в элементе, свойству которого IsManipulationEnabled присвоено значение true , когда пользователь помещает на него палец. По умолчанию последующие события манипуляции сообщают о позиции манипуляции относительно элемента, для которого задано IsManipulationEnabled значение true. Можно указать, что положение должно быть относительно другого элемента, задав ManipulationContainer свойство . Например, можно сделать манипуляцию относительно родительского элемента.

Кроме того, в обработчике событий для ManipulationStartingможно выполнить следующие действия:

• Укажите, требуется ли пользователю более одного пальца для выполнения манипуляций, задав ManipulationStartingEventArgs.IsSingleTouchEnabled свойство .

• Укажите, какие типы манипуляций включены, ManipulationStartingEventArgs.Mode задав для свойства перечисление ManipulationModes .

• Укажите центр поворота одним пальцем, задав ManipulationStartingEventArgs.Pivot свойство .

• Отмените манипуляцию, вызвав ManipulationStartingEventArgs.Cancel метод .

Дополнительные сведения о манипуляциях см. в разделе Общие сведения о входных данных. Пример приложения, реагирующего на манипуляции, см. в разделе Пошаговое руководство. Создание приложения первого сенсорного ввода.

Сведения о маршрутизируемом событии

Поле идентификатора	ManipulationStartingEvent
Стратегия маршрутизации	Восходящей
Делегат	EventHandler<TEventArgs> имеет тип данных ManipulationStartingEventArgs.