Keyboard.Focus(IInputElement) Metodo

Definizione

Spazio dei nomi:

System.Windows.Input

Assembly:

PresentationCore.dll

Imposta lo stato attivo della tastiera sull'elemento specificato.

public:
 static System::Windows::IInputElement ^ Focus(System::Windows::IInputElement ^ element);

public static System.Windows.IInputElement Focus(System.Windows.IInputElement element);

static member Focus : System.Windows.IInputElement -> System.Windows.IInputElement

Public Shared Function Focus (element As IInputElement) As IInputElement

Parametri

element

IInputElement

Elemento su cui impostare lo stato attivo della tastiera.

Restituisce

IInputElement

Elemento con lo stato attivo della tastiera.

Esempio

Nell'esempio seguente viene illustrato un Loaded gestore eventi che imposta lo stato attivo della tastiera su un oggetto Button.

private void OnLoaded(object sender, RoutedEventArgs e)
{
    // Sets keyboard focus on the first Button in the sample.
    Keyboard.Focus(firstButton);
}

Private Sub OnLoaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
    ' Sets keyboard focus on the first Button in the sample.
    Keyboard.Focus(firstButton)
End Sub

Commenti

Affinché un elemento riceva l'input da tastiera, l'elemento deve essere attivabile. Per rendere attivabile un elemento, impostare la Focusable proprietà sull'elemento di base su true. Per altre informazioni sugli elementi di base, vedere Cenni preliminari sugli elementi di base. Panel Le classi, ad esempio StackPanel e Canvas, impostano il valore predefinito di Focusable su false. Di conseguenza, per ottenere lo stato attivo della tastiera, Focusable è necessario impostare su true.

Lo stato attivo della tastiera fa riferimento all'oggetto che riceve l'input da tastiera. L'elemento con lo stato attivo della tastiera è IsKeyboardFocused impostato su true. Può essere presente un solo elemento con lo stato attivo della tastiera sull'intero desktop. Lo stato attivo logico fa riferimento all'oggetto all'interno di un ambito dello stato attivo con stato attivo. Per altre informazioni sullo stato attivo, lo stato attivo della tastiera e lo stato attivo logico, vedere Panoramica dell'input e Panoramica dello stato attivo.

Un elemento con lo stato attivo della tastiera ha anche lo stato attivo logico per l'ambito dello stato attivo a cui appartiene l'elemento. Un elemento con stato attivo logico può avere o meno lo stato attivo della tastiera.