UIElement.ManipulationStarting Evento

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationCore.dll

Se produce cuando se crea por primera vez el procesador de manipulación.

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) 

Tipo de evento

EventHandler<ManipulationStartingEventArgs>

Ejemplos

En el ejemplo siguiente se muestra el controlador de eventos para el ManipulationStarting evento y se establece en ManipulationContainer el elemento primario que recibe los eventos de manipulación para que las coordenadas de la manipulación sean relativas al elemento primario. Este ejemplo forma parte de un ejemplo más grande en Walkthrough: Creating Your First Touch Application.

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

Comentarios

El ManipulationStarting evento se produce en un elemento que tiene la IsManipulationEnabled propiedad establecida true en cuando el usuario coloca un dedo sobre él. De forma predeterminada, los eventos de manipulación posteriores notifican la posición de la manipulación en relación con el elemento que se ha IsManipulationEnabled establecido en true. Puede especificar que la posición debe ser relativa a otro elemento estableciendo la ManipulationContainer propiedad . Por ejemplo, puede realizar la manipulación en relación con el elemento primario del elemento.

También puede hacer lo siguiente en un controlador de eventos para ManipulationStarting:

• Especifique si el usuario necesita más de un dedo para realizar las manipulaciones estableciendo la ManipulationStartingEventArgs.IsSingleTouchEnabled propiedad .

• Especifique qué tipos de manipulación están habilitados estableciendo la ManipulationStartingEventArgs.Mode propiedad en una ManipulationModes enumeración.

• Especifique el centro de una rotación de un solo dedo estableciendo la ManipulationStartingEventArgs.Pivot propiedad .

• Cancele la manipulación llamando al ManipulationStartingEventArgs.Cancel método .

Para obtener más información sobre las manipulaciones, consulte Introducción a la entrada. Para obtener un ejemplo de una aplicación que responde a las manipulaciones, consulte Tutorial: Creación de la primera aplicación táctil.

Información sobre eventos enrutados

Campo identificador	ManipulationStartingEvent
Estrategia de enrutamiento	Burbujeante
Delegado	EventHandler<TEventArgs> de tipo ManipulationStartingEventArgs.