UIElement.ManipulationCompleted Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica al completamento di una manipolazione dell'oggetto UIElement .
public:
virtual event ManipulationCompletedEventHandler ^ ManipulationCompleted;// Register
event_token ManipulationCompleted(ManipulationCompletedEventHandler const& handler) const;
// Revoke with event_token
void ManipulationCompleted(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::ManipulationCompleted_revoker ManipulationCompleted(auto_revoke_t, ManipulationCompletedEventHandler const& handler) const;public event ManipulationCompletedEventHandler ManipulationCompleted;function onManipulationCompleted(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationcompleted", onManipulationCompleted);
uIElement.removeEventListener("manipulationcompleted", onManipulationCompleted);
- or -
uIElement.onmanipulationcompleted = onManipulationCompleted;Public Custom Event ManipulationCompleted As ManipulationCompletedEventHandler <uiElement ManipulationCompleted="eventhandler"/>
Tipo evento
Commenti
Per i controlli personalizzati e le esperienze di interazione, vedere GestureRecognizer.ManipulationCompleted.
Un elemento deve avere un valore ManipulationMode diverso da None o System per essere un'origine evento di manipolazione. Il valore predefinito di ManipulationMode è System, che consente la logica di controllo predefinita per elaborare le manipolazioni, ma non consente al codice dell'app di gestire gli eventi di manipolazione. Per gestire le manipolazioni, impostare ManipulationMode su All o su valori ManipulationModes specifici. Per altre info, vedi ManipulationMode.
ManipulationCompleted è un evento indirizzato. Se l'evento è autorizzato a passare a elementi padre perché non viene gestito, è possibile gestire l'evento sugli elementi padre anche se ManipulationMode è None o System nell'elemento padre. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.
Per le azioni tocco e per gli eventi di modifica o specifici dell'interazione che sono la conseguenza di un'azione tocco, un elemento deve essere visibile tramite hit testing per poter essere l'origine dell'evento e attivare l'evento associato all'azione. UIElement.Visibility deve essere Visible. Altre proprietà dei tipi derivati influiscono anche sulla visibilità degli hit test. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.
ManipulationCompleted supporta la possibilità di collegare gestori eventi alla route che verrà richiamata anche se i dati dell'evento per l'evento sono contrassegnati come Handled. Vedere AddHandler.
Comportamento di Windows 8
Windows 8 non attiva ManipulationCompleted nei casi in cui è stata avviata la fase inerziale (e ManipulationInertiaStarting è stato attivato), ma l'utente ha toccato l'elemento prima del completamento dello scorrimento, che annulla visivamente la fase inerziale. Il problema è stato risolto a partire da Windows 8.1; ManipulationCompleted viene attivato non appena l'azione di tocco annulla la fase inerziale.
Le app create per Windows 8 che vengono eseguite in Windows 8.1 continuano a usare il comportamento di Windows 8.