Condividi tramite


UIElement.GotFocus Evento

Definizione

Si verifica quando un UIElement riceve lo stato attivo. Questo evento viene generato in modo asincrono, quindi lo stato attivo può nuovamente spostarsi prima che venga completato il bubbling.

// Register
event_token GotFocus(RoutedEventHandler const& handler) const;

// Revoke with event_token
void GotFocus(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::GotFocus_revoker GotFocus(auto_revoke_t, RoutedEventHandler const& handler) const;
public event RoutedEventHandler GotFocus;
function onGotFocus(eventArgs) { /* Your code */ }
uIElement.addEventListener("gotfocus", onGotFocus);
uIElement.removeEventListener("gotfocus", onGotFocus);
- or -
uIElement.ongotfocus = onGotFocus;
Public Custom Event GotFocus As RoutedEventHandler 
<uiElement GotFocus="eventhandler"/>

Tipo evento

Commenti

È consigliabile usare gli eventi indirizzati dello stato attivo UIElement anziché gli eventi FocusManager ogni volta che è possibile.

Solo un singolo elemento dell'interfaccia utente alla volta può avere lo stato attivo.

Un controllo può ottenere lo stato attivo quando un altro controllo perde lo stato attivo, la visualizzazione dell'applicazione cambia, le applicazioni dell'utente o l'utente interagisce con il sistema in modo che l'applicazione non sia più in primo piano.

LostFocus viene generato prima di GotFocus.

Se si usa la composizione del controllo o la composizione dell'interfaccia utente e la gestione di GotFocus in un contenitore, ad esempio un pannello o GridView, è possibile controllare OriginalSource sui dati dell'evento per determinare quale elemento nella composizione ha effettivamente ricevuto lo stato attivo.

GotFocus non dispone di dati di eventi specializzati. Dove si gestisce GotFocus, è possibile determinare se è stato l'utente o il codice dell'app che ha causato un elemento per ottenere lo stato attivo. Per determinare questo problema nel gestore, eseguire il cast del mittente dell'evento come oggetto Control e controllare FocusState.

Lo stato attivo della tastiera è particolarmente rilevante per la gestione degli eventi della tastiera, perché solo l'uiElement attualmente incentrato sulla tastiera può essere l'origine degli eventi chiave KeyUp e KeyDown. Le applicazioni possono chiamare Focus come azione di inizializzazione in modo che gli eventi chiave nell'app possano essere usati per rilevare l'accesso o le chiavi di scelta rapida. Per altre info, vedi Interazioni con la tastiera.

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

I controlli specifici Windows Runtime possono avere la gestione basata sulla classe per l'evento GotFocus. In tal caso, il controllo ha probabilmente un override per il metodo OnGotFocus. In genere l'evento viene contrassegnato come gestito dal gestore della classe e l'evento GotFocus non viene generato per la gestione da parte di qualsiasi gestori di codice utente su tale controllo. I controlli possono gestire l'evento per caricare una proprietà dello stato visivo che visualizza un rettangolo di stato attivo.

Il rettangolo dello stato attivo di un controllo è un componente visivo importante che aiuta l'accessibilità identificando l'elemento attivo corrente e indicando dove l'utente si trova all'interno della sequenza di schede dell'interfaccia utente dell'applicazione. In alcuni casi, lo Stato attivo dell'azione messa a fuoco è rilevante per determinare se deve essere visualizzato un indicatore dello stato attivo visibile.

Per altre informazioni sulla gestione basata sulla classe per gli eventi, vedere Panoramica degli eventi e degli eventi indirizzati. Per altre informazioni sulle sequenze di schede e sull'accessibilità, vedere Accessibilità della tastiera.

Si applica a

Vedi anche