Keyboard.Focus(IInputElement) Keyboard.Focus(IInputElement) Keyboard.Focus(IInputElement) Keyboard.Focus(IInputElement) Method

Определение

Устанавливает фокус клавиатуры на указанный элемент.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

Параметры

element
IInputElement IInputElement IInputElement IInputElement

Элемент, на который устанавливается фокус клавиатуры.The element on which to set keyboard focus.

Возвраты

Элемент с фокусом клавиатуры.The element with keyboard focus.

Примеры

В следующем примере показан Loaded обработчик событий, который устанавливает фокус клавиатуры Buttonна.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

Комментарии

Чтобы элемент получал ввод с клавиатуры, элемент должен быть в фокусе.For an element to receive keyboard input, the element must be focusable. Чтобы сделать элемент неактивным, установите Focusable для trueсвойства базового элемента значение.To make an element focusable, set the Focusable property on the base element to true. Дополнительные сведения об основных элементах см. в разделе Общие сведения о базовых элементах.For more information on the base elements, see Base Elements Overview. Panelклассы, такие как StackPanel и Canvas, Focusable устанавливают значение по умолчанию равным false Focusable ; таким образом, для получения фокуса клавиатуры для trueэтих объектов необходимо установить.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.

Фокус клавиатуры относится к объекту, получающему ввод с клавиатуры.Keyboard focus refers to the object that is receiving keyboard input. Элемент с фокусом клавиатуры имеет IsKeyboardFocused trueзначение.The element with keyboard focus has IsKeyboardFocused set to true. На всем рабочем столе может быть только один элемент с фокусом клавиатуры.There can be only one element with keyboard focus on the entire desktop. Логический фокус относится к объекту в области фокуса, имеющей фокус.Logical focus refers to the object within a focus scope that has focus. Дополнительные сведения о фокусе, фокусе клавиатуры и логическом фокусе см. в разделе Общие сведения о входе и Общие сведения о фокусе.For more information on focus, keyboard focus, and logical focus, see Input Overview and Focus Overview.

Элемент с фокусом клавиатуры также имеет логический фокус для области фокуса, к которой принадлежит элемент.An element with keyboard focus also has logical focus for the focus scope the element belongs to. Элемент с логическим фокусом может иметь или не иметь фокуса клавиатуры.An element with logical focus may or may not have keyboard focus.

Применяется к