Keyboard.GotKeyboardFocus Zdarzenie dołączone

Definicja

Występuje, gdy element otrzymuje fokus klawiatury.Occurs when an element receives keyboard focus.

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

Przykłady

Poniższy przykład tworzy TextBox i dołącza programy obsługi zdarzeń dla zdarzenia GotKeyboardFocus i zdarzenia LostKeyboardFocus.The following example creates a TextBox and attaches event handlers for the GotKeyboardFocus event and the LostKeyboardFocus event. Gdy TextBox uzyskuje fokus klawiatury, kolor tła zostanie zmieniony i tekst TextBox zostanie wyczyszczony.When the TextBox obtains keyboard focus, the background color is changed and the text of the TextBox is cleared. Gdy TextBlock utraci fokus klawiatury, kolor tła zostanie zmieniony i wywoływana jest metoda, która resetuje zmienne używane w przykładzie.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

Uwagi

To jest dołączone zdarzenie.This is an attached event. WPFWPF implementuje dołączone zdarzenia jako zdarzenia kierowane.implements attached events as routed events. Dołączone zdarzenia są zasadniczo XAMLXAML koncepcji językowej dla odwołań do zdarzeń, które mogą być obsługiwane na obiektach, które nie definiują tego zdarzenia, które WPFWPF rozszerzają się, włączając jednocześnie zdarzenie przechodzenia do trasy.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. Dołączone zdarzenia nie mają bezpośredniej składni obsługi w kodzie; Aby dołączyć procedury obsługi dla zdarzenia kierowanego w kodzie, należy użyć wskazanej metody dodawania * procedury obsługi.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. Aby uzyskać szczegółowe informacje, zobacz Omówienie załączonych zdarzeń.For details, see Attached Events Overview.

Fokus klawiatury odwołuje się do obiektu, który otrzymuje dane wejściowe z klawiatury.Keyboard focus refers to the object that is receiving keyboard input. Element z fokusem klawiatury ma IsKeyboardFocused ustawiony na true.The element with keyboard focus has IsKeyboardFocused set to true. Na całym pulpicie może istnieć tylko jeden element z fokusem klawiatury.There can be only one element with keyboard focus on the entire desktop. Fokus logiczny odnosi się do obiektu w zakresie fokusu, który ma fokus.Logical focus refers to the object within a focus scope that has focus. Aby uzyskać więcej informacji na temat fokusu, fokus klawiatury i koncentracji logicznej, zobacz przegląd danych wejściowych i Omówienie koncentracji uwagi.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

Jeśli zdarzenie PreviewGotKeyboardFocus lub zdarzenie PreviewLostKeyboardFocus są obsługiwane, fokus klawiatury zostanie zmieniony.If the PreviewGotKeyboardFocus event or the PreviewLostKeyboardFocus event is handled, keyboard focus does change.

Informacje dotyczące kierowanego zdarzeniaRouted Event Information

Pole identyfikatoraIdentifier field GotKeyboardFocusEvent
Strategia routinguRouting strategy PropagacjaBubbling
DelegateDelegate KeyboardFocusChangedEventHandler

Dotyczy