UIElement.TryStartDirectManipulation(Pointer) Metodo

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Riprende l'elaborazione di manipolazione diretta (panoramica/zoom definita dal sistema) in qualsiasi elemento padre ScrollViewer contenente l'oggetto UIElement corrente.

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

Parametri

value

Pointer

Punto di tocco attivo che ha avviato la manipolazione.

Restituisce

Boolean

bool

true se esiste un padre ScrollViewer e l'impostazione del valore ha generato la ripresa dell'azione di panoramica/zoom. false se si chiama il metodo non viene eseguita alcuna azione.

Commenti

Per impostazione predefinita, le interazioni di input tocco negli elementi ScrollViewer vengono gestite dal motore di manipolazione diretta dal thread dell'interfaccia utente. Un'app non può elaborare direttamente gli eventi puntatore associati dopo l'avvio dell'elaborazione della manipolazione diretta . È possibile chiamare CancelDirectManipulations all'inizio di un'interazione ScrollViewer e gestire gli eventi del puntatore nel thread dell'interfaccia utente, che consente di eseguire la gestione degli input personalizzati in un ScrollVieweroggetto .

Se si annulla l'elaborazione della manipolazione diretta all'inizio di un'interazione ScrollViewer , è possibile chiamare TryStartDirectManipulation per riprendere il processo di manipolazione diretta del flusso di input. In questo modo è possibile eseguire prima l'elaborazione di input personalizzata e quindi riprendere la gestione della manipolazione diretta per rendere l'app più reattiva alle interazioni tocco come lo scorrimento e lo zoom.

Solo i contatti tocco attivi possono essere passati a Manipolazione diretta. L'uso di contatti non attivi o non touch causa la generazione di un'eccezione.

Se si specifica un contatto tocco per passare a Manipolazione diretta , il framework passa alla catena padre e imposta il contatto sul riquadro di visualizzazione Manipolazione diretta di ogni oggetto ScrollViewer in ordine, fino a quando la passeggiata raggiunge qualsiasi elemento (incluso l'elemento di destinazione originale) che non ha un oggetto ManipulationMode che contiene ManipulationModes.System. Un contatto tocco specificato può essere associato solo a una singola catena di oggetti visivi alla volta. La chiamata TryStartDirectManipulation più di una volta allo stesso contatto comporta il rilascio di qualsiasi catena precedente.

Vedi anche

• CancelDirectManipulations()
• ManipulationStarted
• ManipulationModes
• Movimenti, manipolazioni e interazioni
• Manipolazione diretta