UIElement.TryStartDirectManipulation(Pointer) Metodo

Definizione

Riprende l'elaborazione diretta della manipolazione (panoramica/zoom definita dal sistema) su qualsiasi elemento padre scrollViewer che contiene l'oggetto UIElement corrente.

C#
public static bool TryStartDirectManipulation(Pointer value);

Parametri

value
Pointer

Punto di tocco attivo che ha avviato la manipolazione.

Restituisce

Boolean

true se esiste un elemento padre ScrollViewer e l'impostazione del valore ha comportato la ripresa dell'azione di panoramica/zoom. false se la chiamata al metodo non comporta alcuna azione.

Commenti

Per impostazione predefinita, le interazioni di input tocco negli elementi ScrollViewer vengono gestite dal motore di manipolazione diretta fuori 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 dell'input personalizzata in un controllo ScrollViewer.

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 puoi prima eseguire l'elaborazione dell'input personalizzata e quindi riprendere la gestione della manipolazione diretta per rendere l'app più reattiva alle interazioni tramite tocco, ad esempio lo scorrimento e lo zoom.

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

Se si specifica un contatto tocco da passare alla manipolazione diretta , il framework raggiunge la catena padre e imposta il contatto sul riquadro di visualizzazione Manipolazione diretta di ogni ScrollViewer rilevato nell'ordine, fino a raggiungere qualsiasi elemento (incluso l'elemento di destinazione originale) che non abbia un ManipulationMode che contiene ManipulationModes.System. Un determinato contatto tocco può essere associato solo a una singola catena di oggetti visivi alla volta. La chiamata a TryStartDirectManipulation più volte nello stesso contatto comporta il rilascio di qualsiasi catena precedente.

Si applica a

Prodotto Versioni
WinRT Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100

Vedi anche