UIElement.ManipulationStarting Evento

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Si verifica quando il processore di manipolazione viene creato per la prima volta.

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 evento

EventHandler<ManipulationStartingEventArgs>

Esempio

Nell'esempio seguente viene illustrato il gestore eventi per l'evento ManipulationStarting e viene impostato sull'elemento ManipulationContainer padre che riceve gli eventi di manipolazione in modo che le coordinate della manipolazione siano relative all'elemento padre. Questo esempio fa parte di un esempio più ampio in Procedura dettagliata: Creazione della prima applicazione 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

Commenti

L'evento ManipulationStarting si verifica su un elemento che ha la IsManipulationEnabled proprietà impostata su true quando l'utente inserisce un dito su di esso. Per impostazione predefinita, gli eventi di manipolazione successivi segnalano la posizione della manipolazione rispetto all'elemento IsManipulationEnabled impostato su true. È possibile specificare che la posizione deve essere relativa a un altro elemento impostando la ManipulationContainer proprietà. Ad esempio, è possibile apportare la manipolazione rispetto all'elemento padre dell'elemento.

È anche possibile eseguire le operazioni seguenti in un gestore eventi per ManipulationStarting:

• Specificare se l'utente deve eseguire più di un dito per eseguire le manipolazioni impostando la ManipulationStartingEventArgs.IsSingleTouchEnabled proprietà.

• Specificare i tipi di manipolazione abilitati impostando la proprietà su un'enumerazione ManipulationStartingEventArgs.ModeManipulationModes .

• Specificare il centro di una rotazione a dito singolo impostando la ManipulationStartingEventArgs.Pivot proprietà.

• Annullare la manipolazione chiamando il ManipulationStartingEventArgs.Cancel metodo .

Per altre informazioni sulle manipolazioni, vedere Panoramica dell'input. Per un esempio di applicazione che risponde alle manipolazioni, vedere Procedura dettagliata: Creazione della prima applicazione touch.

Informazioni evento indirizzato

Campo Identificatore	ManipulationStartingEvent
Strategia di routing	Bubbling
Delegato	EventHandler<TEventArgs> di tipo ManipulationStartingEventArgs.