FocusManager.SetFocusedElement(DependencyObject, IInputElement) Método

Definição

Namespace:

System.Windows.Input

Assembly:

PresentationCore.dll

Determina o foco lógico no elemento especificado.

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)

Parâmetros

element

DependencyObject

O escopo do foco no qual o elemento especificado se torna FocusedElement.

value

IInputElement

O elemento a receber foco lógico.

Exemplos

O exemplo a seguir define o elemento com foco lógico usando o SetFocusedElement e obtém o elemento com foco lógico usando o 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)

Comentários

O FocusedElement é o elemento que tem foco lógico para o escopo de foco específico. Esse objeto pode ou não ter o foco do teclado. O foco do teclado refere-se ao elemento que recebe a entrada do teclado. Para obter mais informações sobre foco, foco do teclado e foco lógico, consulte a Visão geral de entrada.

É possível especificar um escopo de foco que seja um ancestral do escopo de foco em que o elemento está. Por exemplo, se um for um StackPanel escopo de foco e seu pai Window for um escopo de foco, um TextBox filho do StackPanel poderá especificar o Window como o escopo de foco ao chamar SetFocusedElement. O TextBox é então FocusedElement para o escopo de Window foco e o escopo de StackPanel foco.

SetFocusedElement fornecerá o foco lógico do elemento especificado no escopo de foco especificado e tentará dar ao elemento o foco do teclado.