Keyboard.GotKeyboardFocus Keyboard.GotKeyboardFocus Keyboard.GotKeyboardFocus Attached Event

Définition

Se produit quand un élément reçoit le focus clavier.Occurs when an element receives keyboard focus.

see AddGotKeyboardFocusHandler, and RemoveGotKeyboardFocusHandler
see AddGotKeyboardFocusHandler, and RemoveGotKeyboardFocusHandler
see AddGotKeyboardFocusHandler, and RemoveGotKeyboardFocusHandler

Exemples

L’exemple suivant crée un TextBox et attache les gestionnaires d’événements pour le GotKeyboardFocus événement et le LostKeyboardFocus événement.The following example creates a TextBox and attaches event handlers for the GotKeyboardFocus event and the LostKeyboardFocus event. Lorsque le TextBox Obtient le focus clavier, la couleur d’arrière-plan est modifiée et le texte de la TextBox est désactivée.When the TextBox obtains keyboard focus, the background color is changed and the text of the TextBox is cleared. Lorsque le TextBlock perd le focus clavier, la couleur d’arrière-plan est modifiée et une méthode est appelée, qui réinitialise les variables utilisées dans l’exemple.When the TextBlock loses keyboard focus, the background color is changed and a method is called which resets variables used in the sample.

<Border BorderBrush="Black" BorderThickness="1"
        Width="200" Height="100" Margin="5">
  <StackPanel>
    <Label HorizontalAlignment="Center" Content="Type Text In This TextBox" />
    <TextBox Width="175"
             Height="50" 
             Margin="5"
             TextWrapping="Wrap"
             HorizontalAlignment="Center"
             VerticalScrollBarVisibility="Auto"
             GotKeyboardFocus="TextBoxGotKeyboardFocus"
             LostKeyboardFocus="TextBoxLostKeyboardFocus"
             KeyDown="SourceTextKeyDown"/>
  </StackPanel>
</Border>
private void TextBoxGotKeyboardFocus(object sender, KeyboardFocusChangedEventArgs e)
{
    TextBox source = e.Source as TextBox;

    if (source != null)
    {
        // Change the TextBox color when it obtains focus.
        source.Background = Brushes.LightBlue;

        // Clear the TextBox.
        source.Clear();
    }
}
Private Sub TextBoxGotKeyboardFocus(ByVal sender As Object, ByVal e As KeyboardFocusChangedEventArgs)
	Dim source As TextBox = TryCast(e.Source, TextBox)

	If source IsNot Nothing Then
		' Change the TextBox color when it obtains focus.
		source.Background = Brushes.LightBlue

		' Clear the TextBox.
		source.Clear()
	End If
End Sub
private void TextBoxLostKeyboardFocus(object sender, KeyboardFocusChangedEventArgs e)
{
    TextBox source = e.Source as TextBox;

    if (source != null)
    {
        // Change the TextBox color when it loses focus.
        source.Background = Brushes.White;

        // Set the  hit counter back to zero and updates the display.
        this.ResetCounter();
    }
}
Private Sub TextBoxLostKeyboardFocus(ByVal sender As Object, ByVal e As KeyboardFocusChangedEventArgs)
	Dim source As TextBox = TryCast(e.Source, TextBox)

	If source IsNot Nothing Then
		' Change the TextBox color when it loses focus.
		source.Background = Brushes.White

		' Set the  hit counter back to zero and updates the display.
		Me.ResetCounter()
	End If
End Sub

Remarques

Il s’agit d’un événement attaché.This is an attached event. WPFWPF implémente les événements attachés en tant qu’événements routés.implements attached events as routed events. Événements attachés sont fondamentalement un XAMLXAML concept de langage pour faire référence à des événements qui peuvent être gérés sur des objets qui ne définissent pas cet événement, ce qui WPFWPF étend en permettant également l’événement à parcourir un itinéraire.Attached events are fundamentally a XAMLXAML language concept for referencing events that can be handled on objects that do not define that event, which WPFWPF expands upon by also enabling the event to traverse a route. Événements attachés n’ont pas de syntaxe de gestion directe dans le code ; Pour attacher des gestionnaires pour un événement routé dans le code, vous utilisez un ajouter désigné * méthode de gestionnaire.Attached events do not have a direct handling syntax in code; to attach handlers for a routed event in code, you use a designated Add*Handler method. Pour plus d’informations, consultez vue d’ensemble des événements attachés.For details, see Attached Events Overview.

Le focus clavier fait référence à l’objet qui reçoit l’entrée au clavier.Keyboard focus refers to the object that is receiving keyboard input. L’élément ayant le focus clavier a IsKeyboardFocused défini sur true.The element with keyboard focus has IsKeyboardFocused set to true. Il peut y avoir qu’un seul élément ayant le focus clavier sur l’intégralité du bureau.There can be only one element with keyboard focus on the entire desktop. Le focus logique fait référence à l’objet dans une portée de focus qui a le focus.Logical focus refers to the object within a focus scope that has focus. Pour plus d’informations sur le focus, le focus clavier et le focus logique, consultez vue d’ensemble de l’entrée et vue d’ensemble du Focus.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

Si le PreviewGotKeyboardFocus événement ou la PreviewLostKeyboardFocus est géré, le focus clavier ne change pas.If the PreviewGotKeyboardFocus event or the PreviewLostKeyboardFocus event is handled, keyboard focus does change.

Informations sur les événements acheminésRouted Event Information

Champ d’identificateurIdentifier field GotKeyboardFocusEvent
Stratégie de routageRouting strategy PropagationBubbling
déléguéDelegate KeyboardFocusChangedEventHandler

S’applique à