UIElement.ManipulationStarting 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 quando il processore di manipolazione viene creato per la prima volta.
public:
virtual event ManipulationStartingEventHandler ^ ManipulationStarting;// Register
event_token ManipulationStarting(ManipulationStartingEventHandler const& handler) const;
// Revoke with event_token
void ManipulationStarting(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::ManipulationStarting_revoker ManipulationStarting(auto_revoke_t, ManipulationStartingEventHandler const& handler) const;public event ManipulationStartingEventHandler ManipulationStarting;function onManipulationStarting(eventArgs) { /* Your code */ }
uIElement.addEventListener("manipulationstarting", onManipulationStarting);
uIElement.removeEventListener("manipulationstarting", onManipulationStarting);
- or -
uIElement.onmanipulationstarting = onManipulationStarting;Public Custom Event ManipulationStarting As ManipulationStartingEventHandler <uiElement ManipulationStarting="eventhandler"/>
Tipo evento
Commenti
Per i controlli personalizzati e le esperienze di interazione, vedere GestureRecognizer.
Un elemento deve avere un valore ManipulationMode diverso da Nessuno 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. Se si desidera gestire le manipolazioni, impostare ManipulationMode su Tutti o su valori ManipulationModes specifici. Per altre informazioni, vedere ManipulationMode.
ManipulationStarting genera fondamentalmente qualsiasi momento in cui un puntatore interagisce con un elemento in cui l'elemento abilita la manipolazione. Ciò include casi in cui la manipolazione viene interpretata come un gesto e i puntatori non si spostano mai, ad esempio un movimento toccato o tenendopremuto. Se i puntatori vengono spostati, ManipulationStarted viene in genere attivato in seguito.
ManipulationStarting è un evento indirizzato. Se l'evento è autorizzato a bolle fino agli elementi padre perché non viene gestito, è possibile gestire l'evento sugli elementi padre anche se ManipulationMode è None o System nell'elemento padre. Per altre informazioni sul concetto di evento indirizzato, vedere 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 visibile. Altre proprietà dei tipi derivati influiscono anche sulla visibilità di hit test. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.
ManipulationStarting 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 ha avuto un problema con l'attivazione di questo evento se più movimenti si sono verificati in un breve periodo di tempo. Ad esempio, Windows 8 potrebbe generare solo ManipulationStarting per il primo gesto e non il secondo. Il problema viene risolto a partire da Windows 8.1; più movimenti iniziali elaborati dal sistema di input generano un evento ManipulationStarting distinto.
Le app create per Windows 8 che vengono eseguite in Windows 8.1 continuano a usare il comportamento di Windows 8.