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 sul quale impostare lo stato attivo della tastiera.

Restituisce

IInputElement

Elemento con lo stato attivo.

Esempio

Nell'esempio seguente viene illustrato un gestore eventi che imposta lo Loaded stato attivo sulla tastiera su un Buttonoggetto .

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

Per consentire a un elemento di ricevere l'input della tastiera, l'elemento deve essere attivo. Per rendere attivo un elemento, impostare la proprietà sull'elemento Focusable base su true. Per altre informazioni sugli elementi di base, vedere Panoramica degli elementi di base. Panelle classi, ad esempio StackPanel e Canvas, impostano il valore predefinito su falseFocusable ; pertanto, per questi oggetti 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 della 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 di 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 lo stato attivo logico può o non avere lo stato attivo della tastiera.