Keyboard.Focus(IInputElement) Metodo

Definizione

Imposta lo stato attivo della tastiera sull'elemento specificato.Sets keyboard focus on the specified element.

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.The element on which to set keyboard focus.

Restituisce

Elemento con lo stato attivo.The element with keyboard focus.

Esempi

Nell'esempio seguente viene illustrato Loaded un gestore eventi che imposta lo stato attivo Buttondella tastiera su un oggetto.The following example shows a Loaded event handler that sets keyboard focus on a 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

Per ricevere input da tastiera, l'elemento deve essere attivabile.For an element to receive keyboard input, the element must be focusable. Per rendere un elemento attivabile, impostare la Focusable proprietà dell'elemento di truebase su.To make an element focusable, set the Focusable property on the base element to true. Per altre informazioni sugli elementi di base, vedere Cenni preliminari sugli elementi di base.For more information on the base elements, see Base Elements Overview. Panelle classi, ad StackPanel esempio Canvase, impostano il Focusable valore falsepredefinito di su; pertanto, affinché questi oggetti ottengano Focusable lo stato attivo, trueè necessario impostare su.Panel classes, such as StackPanel and Canvas, set the default value of Focusable to false; therefore, for these objects to obtain keyboard focus, Focusable must be set to true.

Lo stato attivo della tastiera fa riferimento all'oggetto che riceve l'input da tastiera.Keyboard focus refers to the object that is receiving keyboard input. L'elemento con lo stato attivo IsKeyboardFocused della tastiera trueè impostato su.The element with keyboard focus has IsKeyboardFocused set to true. Può essere presente un solo elemento con lo stato attivo della tastiera sull'intero desktop.There can be only one element with keyboard focus on the entire desktop. Lo stato attivo logico fa riferimento all'oggetto all'interno di un ambito di stato attivo con lo stato attivo.Logical focus refers to the object within a focus scope that has focus. Per altre informazioni sullo stato attivo, lo stato attivo della tastiera e lo stato attivo logico, vedere Cenni preliminari sull' input e Panoramica dello stato attivo.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

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.An element with keyboard focus also has logical focus for the focus scope the element belongs to. Un elemento con lo stato attivo logico può avere o meno lo stato attivo della tastiera.An element with logical focus may or may not have keyboard focus.

Si applica a