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 None
o System
per essere un'origine evento di manipolazione. Il valore predefinito di è System
, che consente la logica di controllo predefinita per elaborare le manipolazioni, ma non consente al codice dell'app ManipulationMode
di gestire gli eventi di manipolazione. Per gestire le manipolazioni, impostare ManipulationMode
su All
o su valori ManipulationModes specifici. Per altre info, vedi ManipulationMode
.
ManipulationStarting
viene generato fondamentalmente ogni volta che 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 instradato. 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
sull'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.