FocusManager.SetFocusedElement(DependencyObject, IInputElement) Метод

Определение

Устанавливает логический фокус на указанный элемент.Sets logical focus on the specified element.

public:
 static void SetFocusedElement(System::Windows::DependencyObject ^ element, System::Windows::IInputElement ^ value);
public static void SetFocusedElement (System.Windows.DependencyObject element, System.Windows.IInputElement value);
static member SetFocusedElement : System.Windows.DependencyObject * System.Windows.IInputElement -> unit
Public Shared Sub SetFocusedElement (element As DependencyObject, value As IInputElement)

Параметры

element
DependencyObject

Область фокуса, в которой следует сделать указанный элемент элементом FocusedElement.The focus scope in which to make the specified element the FocusedElement.

value
IInputElement

Элемент, которому следует передать логический фокус.The element to give logical focus to.

Примеры

В следующем примере элемент с логическим фокусом задается с помощью SetFocusedElement и получает элемент с логическим фокусом с помощью GetFocusedElement.The following example sets the element with logical focus by using the SetFocusedElement and it gets the element with logical focus by using the GetFocusedElement.

// Sets the focused element in focusScope1
// focusScope1 is a StackPanel.
FocusManager.SetFocusedElement(focusScope1, button2);

// Gets the focused element for focusScope 1
IInputElement focusedElement = FocusManager.GetFocusedElement(focusScope1);
' Sets the focused element in focusScope1
' focusScope1 is a StackPanel.
FocusManager.SetFocusedElement(focusScope1, button2)

' Gets the focused element for focusScope 1
Dim focusedElement As IInputElement = FocusManager.GetFocusedElement(focusScope1)

Комментарии

FocusedElement — это элемент, имеющий логический фокус для определенной области фокуса.The FocusedElement is the element that has logical focus for the specific focus scope. Этот объект может иметь или не иметь фокуса клавиатуры.This object may or may not have keyboard focus. Фокус клавиатуры относится к элементу, который получает ввод с клавиатуры.Keyboard focus refers to the element that receives keyboard input. Дополнительные сведения о фокусе, фокусе клавиатуры и логическом фокусе см. в разделе Общие сведения о входных данных.For more information on focus, keyboard focus, and logical focus, see the Input Overview.

Можно указать область фокуса, которая является предком области фокуса, в которой находится элемент.It is possible to specify a focus scope that is an ancestor of the focus scope the element is in. Например, если StackPanel является областью фокуса, а ее родительский Window является областью фокуса, TextBox дочерний элемент StackPanel может указать Window в качестве области фокуса при вызове SetFocusedElement.For example, if a StackPanel is a focus scope and its parent Window is a focus scope, a TextBox child of the StackPanel could specify the Window as the focus scope when calling SetFocusedElement. Затем TextBox FocusedElement для области фокуса Window и области фокуса StackPanel.The TextBox is then FocusedElement for both the Window focus scope and the StackPanel focus scope.

SetFocusedElement предоставит указанный элемент логический фокус в заданной области фокуса и попытается предоставить фокус клавиатуры элемента.SetFocusedElement will give the specified element logical focus in the specified focus scope and will attempt to give the element keyboard focus.

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