Condividi tramite


UIElement.KeyDown Evento

Definizione

Si verifica quando viene premuto un tasto da tastiera mentre UIElement ha lo stato attivo.

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 acquisisce lo stato attivo quando l'utente tocca o fa clic direttamente sul controllo nel layout oppure usa il tasto Tab per avviare una sequenza di tabulazione nell'area di contenuto. È anche possibile concentrarsi sui controlli a livello di codice chiamando Control.Focus.

KeyDown è un evento indirizzato. Per altre informazioni sul concetto di evento indirizzato, vedere Panoramica degli eventi e degli eventi indirizzati.

KeyDown usa i dati degli eventi KeyRoutedEventArgs . Per la maggior parte degli scenari con gestori, le proprietà più importanti di KeyRoutedEventArgs sono Key ed eventualmente 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 consentono un'interazione utente basata su tastiera con tale controllo e 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 Spazio o Invio attiverà comunque un evento KeyDown e KeyUp per un pulsante. 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.

Si applica a

Vedi anche