UIElement.ManipulationStarting Événement

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Se produit lorsque le processeur de manipulation est créé initialement.

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) 

Type d'événement

EventHandler<ManipulationStartingEventArgs>

Exemples

L’exemple suivant montre le gestionnaire d’événements pour l’événement ManipulationStarting et définit l’élément ManipulationContainer parent qui reçoit les événements de manipulation afin que les coordonnées de la manipulation soient relatives à l’élément parent. Cet exemple fait partie d’un exemple plus large dans Procédure pas à pas : création de votre application first touch.

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

Remarques

L’événement ManipulationStarting se produit sur un élément dont la IsManipulationEnabled propriété est définie true sur lorsque l’utilisateur y met un doigt. Par défaut, les événements de manipulation suivants signalent la position de la manipulation par rapport à l’élément qui a IsManipulationEnabled défini sur true. Vous pouvez spécifier que la position doit être relative à un autre élément en définissant la ManipulationContainer propriété . Par exemple, vous pouvez effectuer la manipulation par rapport au parent de l’élément.

Vous pouvez également effectuer les opérations suivantes dans un gestionnaire d’événements pour ManipulationStarting:

• Spécifiez si l’utilisateur a besoin de plusieurs doigts pour effectuer les manipulations en définissant la ManipulationStartingEventArgs.IsSingleTouchEnabled propriété .

• Spécifiez les types de manipulation activés en définissant la ManipulationStartingEventArgs.Mode propriété sur une ManipulationModes énumération.

• Spécifiez le centre d’une rotation à doigt unique en définissant la ManipulationStartingEventArgs.Pivot propriété .

• Annulez la manipulation en appelant la ManipulationStartingEventArgs.Cancel méthode .

Pour plus d’informations sur les manipulations, consultez Vue d’ensemble des entrées. Pour obtenir un exemple d’application qui répond aux manipulations, consultez Procédure pas à pas : création de votre première application tactile.

Informations sur les événements acheminés

Champ Identificateur	ManipulationStartingEvent
Stratégie de routage	Bouillonnant
Délégué	EventHandler<TEventArgs> de type ManipulationStartingEventArgs.