UIElement.KeyDown 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.
public:
virtual event KeyEventHandler ^ KeyDown;// Register
event_token KeyDown(KeyEventHandler const& handler) const;
// Revoke with event_token
void KeyDown(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::KeyDown_revoker KeyDown(auto_revoke_t, KeyEventHandler const& handler) const;public event KeyEventHandler KeyDown;function onKeyDown(eventArgs) { /* Your code */ }
uIElement.addEventListener("keydown", onKeyDown);
uIElement.removeEventListener("keydown", onKeyDown);
- or -
uIElement.onkeydown = onKeyDown;Public Custom Event KeyDown As KeyEventHandler <uiElement KeyDown="eventhandler"/>
Tipo evento
Commenti
I controlli nella tua interfaccia utente generano eventi da tastiera solo quando hanno il focus di input. Per impostazione predefinita, il primo elemento attivabile nella struttura ad albero visuale riceve lo stato attivo dal sistema. Un singolo controllo ottiene lo stato attivo quando l'utente fa clic o tocca direttamente su tale controllo nel layout o usa il tasto TAB per eseguire un'istruzione in una sequenza di tabulazioni all'interno dell'area del contenuto. È anche possibile attivare i controlli a livello di codice chiamando UIElement.Focus(Microsoft. UI. Xaml.FocusState).
KeyDown è un evento indirizzato. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.
KeyDown usa i dati dell'evento KeyRoutedEventArgs . Le proprietà più rilevanti di per la maggior parte degli scenari del KeyRoutedEventArgs gestore sono Key e possibilmente KeyStatus. Per altre informazioni sulla gestione degli eventi della tastiera, incluso il codice di esempio per la definizione di un metodo KeyEventHandler , vedi Interazioni tramite tastiera.
Uno scenario per la gestione degli eventi della tastiera consiste nel supportare i tasti di scelta rapida o i tasti di scelta rapida per un'app o un'area o un controllo all'interno di un'app. Per altre info su questo scenario, vedi Accessibilità tramite tastiera.
Specifici controlli Windows Runtime possono avere una gestione basata su classi per l'evento di input KeyDown. In tal caso, il controllo ha probabilmente un override per il metodo OnKeyDown. In genere questi gestori di classe sono progettati per elaborare un subset di tasti che abilitano l'interazione utente basata su tastiera con tale controllo. Spesso, questa interazione supporta una funzionalità di accessibilità tramite tastiera. Se la pressione di un tasto viene gestita dalla gestione basata su classi, la pressione del tasto viene considerata già gestita e l'evento KeyDown non viene generato per la gestione da parte di qualsiasi gestore di codice utente su tale controllo per tale tasto in modo specifico. In genere, questo è solo per alcune chiavi dedicate. Ad esempio, ButtonBase dispone della gestione delle classi in modo che il tasto Space e IL tasto INVIO vengano gestiti come equivalenti da tastiera per richiamare il pulsante. Ciò fornisce un equivalente della tastiera predefinito per toccare il pulsante o fare clic su di esso con un mouse e consente lo scenario di accessibilità dell'uso dell'interfaccia utente e del pulsante usando solo una tastiera. Tuttavia, qualsiasi altra chiave diversa da Space o Enter genererà comunque un evento KeyDown e KeyUp per un oggetto Button. Per altre info sul funzionamento della gestione basata su classi per gli eventi, vedi Panoramica degli eventi e degli eventi indirizzati.
KeyDown 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.