Partilhar via


UIElement.GettingFocus Evento

Definição

Ocorre antes que um UIElement receba o foco. Esse evento é gerado de forma síncrona para garantir que o foco não seja movido enquanto o evento estiver borbulhando.

// Register
event_token GettingFocus(TypedEventHandler<UIElement, GettingFocusEventArgs const&> const& handler) const;

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

// Revoke with event_revoker
UIElement::GettingFocus_revoker GettingFocus(auto_revoke_t, TypedEventHandler<UIElement, GettingFocusEventArgs const&> const& handler) const;
public event TypedEventHandler<UIElement,GettingFocusEventArgs> GettingFocus;
function onGettingFocus(eventArgs) { /* Your code */ }
uIElement.addEventListener("gettingfocus", onGettingFocus);
uIElement.removeEventListener("gettingfocus", onGettingFocus);
- or -
uIElement.ongettingfocus = onGettingFocus;
Public Custom Event GettingFocus As TypedEventHandler(Of UIElement, GettingFocusEventArgs) 
<uiElement GettingFocus="eventhandler"/>

Tipo de evento

Requisitos do Windows

Família de dispositivos
Windows 10 Creators Update (introduzida na 10.0.15063.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v4.0)

Comentários

Recomendamos usar os eventos roteados de foco UIElement em vez de eventos FocusManager sempre que possível.

Somente um único elemento de interface do usuário de cada vez pode ter o foco.

Um controle pode obter foco quando outro controle perde o foco, a exibição do aplicativo muda, o usuário alterna aplicativos ou o usuário interage com o sistema de modo que o aplicativo não esteja mais em primeiro plano.

Ao navegar programaticamente entre elementos, FocusNavigationDirection.Previous e FocusNavigationDirection.Next não podem ser usados com FindNextElementOptions. Somente FocusNavigationDirection.Up, FocusNavigationDirection.Down, FocusNavigationDirection.Left ou FocusNavigationDirection.Right são válidos.

GettingFocus é um evento roteado. Para obter mais informações sobre o conceito de evento roteado, consulte Visão geral de eventos e eventos roteado.

Aplica-se a

Confira também