UIElement.TryStartDirectManipulation(Pointer) Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml

Riprende l'elaborazione diretta della manipolazione (panoramica/zoom definita dal sistema) su qualsiasi elemento padre scrollViewer che contiene 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 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.

Vedi anche

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