FrameworkElement.MoveFocus(TraversalRequest) Método

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Move o foco do teclado para longe desse elemento e para outro elemento em uma direção de passagem fornecida.

public:
 override bool MoveFocus(System::Windows::Input::TraversalRequest ^ request);

public override sealed bool MoveFocus (System.Windows.Input.TraversalRequest request);

override this.MoveFocus : System.Windows.Input.TraversalRequest -> bool

Public Overrides NotOverridable Function MoveFocus (request As TraversalRequest) As Boolean

Parâmetros

request: TraversalRequest

A direção para a qual o foco deve ser movido, como um valor da enumeração.

Retornos

Boolean

Retorna true se o foco é movido com êxito; false se o elemento de destino na direção especificada não existe ou não pode ter o foco do teclado.

Exemplos

O exemplo a seguir implementa um manipulador que manipula várias entradas de botão possíveis. Cada botão representa uma possível FocusNavigationDirection. O manipulador rastreia o elemento com o foco atual do teclado e chama MoveFocus esse elemento, especificando o apropriado FocusNavigationDirection como inicialização para o parâmetro de TraversalRequest tipo fornecido.

// Creating a FocusNavigationDirection object and setting it to a
// local field that contains the direction selected.
FocusNavigationDirection focusDirection = _focusMoveValue;

// MoveFocus takes a TraveralReqest as its argument.
TraversalRequest request = new TraversalRequest(focusDirection);

// Gets the element with keyboard focus.
UIElement elementWithFocus = Keyboard.FocusedElement as UIElement;

// Change keyboard focus.
if (elementWithFocus != null)
{
    elementWithFocus.MoveFocus(request);
}

' Creating a FocusNavigationDirection object and setting it to a
' local field that contains the direction selected.
Dim focusDirection As FocusNavigationDirection = _focusMoveValue

' MoveFocus takes a TraveralReqest as its argument.
Dim request As New TraversalRequest(focusDirection)

' Gets the element with keyboard focus.
Dim elementWithFocus As UIElement = TryCast(Keyboard.FocusedElement, UIElement)

' Change keyboard focus.
If elementWithFocus IsNot Nothing Then
    elementWithFocus.MoveFocus(request)
End If

Comentários

Essa implementação substitui UIElement.MoveFocus e sela o método.

Aplica-se a

Produto	Versões
.NET Framework	3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Compartilhar via