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 dell'interfaccia utente generano eventi della tastiera solo quando hanno lo stato attivo per l'input. Per impostazione predefinita, il primo elemento attivabile nell'albero visivo viene dato lo stato attivo dal sistema. Un singolo controllo ottiene lo stato attivo quando l'utente fa clic o tocca direttamente sul controllo nel layout o usa il tasto Tab per passare a una sequenza di schede all'interno dell'area del contenuto. È anche possibile concentrarsi sui controlli a livello di codice chiamando UIElement.Focus(Microsoft.UI.Xaml.FocusState).
KeyDown è un evento instradato. Per altre informazioni sul concetto di evento indirizzato, vedere Panoramica degli eventi e degli eventi indirizzati.
KeyDown usa i dati degli eventi KeyRoutedEventArgs . Le proprietà più rilevanti di per la maggior parte degli KeyRoutedEventArgs scenari del 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 , vedere Interazioni da tastiera.
Uno scenario per gestire gli eventi della tastiera consiste nel supportare chiavi di accesso o tasti di scelta rapida per un'app o un'area o un controllo all'interno di un'app. Per altre informazioni su questo scenario, vedere Accessibilità della tastiera.
I controlli specifici Windows Runtime possono avere la gestione basata sulla classe per l'evento di input KeyDown. In tal caso, il controllo ha probabilmente un override per il metodo OnKeyDown. In genere questi gestori di classi sono destinati a elaborare un subset di tasti che abilitano l'interazione utente basata su tastiera con tale controllo. Spesso questa interazione supporta una funzionalità di accessibilità della tastiera. Se un tasto viene gestito 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 dei gestori di codice utente su tale controllo per tale tasto in particolare. In genere, questo è solo per alcune chiavi dedicate. Ad esempio, ButtonBase ha la gestione delle classi in modo che il tasto Spazio e INVIO vengano gestiti come equivalenti da tastiera per richiamare il pulsante. Ciò fornisce un equivalente 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 attiverà comunque un evento KeyDown e KeyUp per un Buttonoggetto . Per altre informazioni sulla gestione basata sulla classe per gli eventi, vedere 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.