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 viene creato per la prima volta il processore di manipolazione.
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 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 modifiche, ma non consente al codice dell'app di gestire gli eventi di manipolazione. Se si desidera gestire le manipolazioni, impostare su ManipulationModeAllo su valori ManipulationModes specifici. Per ulteriori informazioni, vedi ManipulationMode.
ManipulationStarting viene generato fondamentalmente ogni volta che un puntatore interagisce con un elemento in cui l'elemento abilita la manipolazione. Sono inclusi i casi in cui la manipolazione viene interpretata come un movimento e i puntatori non si muovono mai, ad esempio un gesto toccato o tenendo premuto. Se i puntatori vengono spostati, ManipulationStarted viene in genere attivato successivamente.
ManipulationStarting è 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 sull'elemento padre. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.
Per le azioni di tocco e anche per gli eventi specifici dell'interazione o di manipolazione che sono conseguenze di un'azione di tocco, un elemento deve essere visibile al test di colpire per poter essere la sorgente dell'evento e generare l'evento associato all'azione. UIElement.Visibility deve essere Visibile. Anche altre proprietà dei tipi derivati influiscono sulla visibilità dei 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.