UIElement.Focus UIElement.Focus UIElement.Focus UIElement.Focus Method

Definición

Intenta establecer el foco en este elemento.Attempts to set focus to this element.

public:
 virtual bool Focus();
public bool Focus ();
abstract member Focus : unit -> bool
override this.Focus : unit -> bool
Public Function Focus () As Boolean

Devoluciones

Devuelve true si el foco de teclado y el foco lógico se establecieron en este elemento; devuelve false si se estableció únicamente el foco lógico en este elemento o si la llamada a este método no forzó un cambio de foco.true if keyboard focus and logical focus were set to this element; false if only logical focus was set to this element, or if the call to this method did not force the focus to change.

Implementaciones

Ejemplos

El ejemplo siguiente establece el foco en un TextBox hace referencia a él Namey, a continuación, ajusta la posición del cursor dentro de la TextBox.The following example sets focus to a TextBox referenced by Name, and then adjusts the position of the cursor within the TextBox.

void OnClickMoveToStart(object sender, RoutedEventArgs e)
{
    tbPositionCursor.Focus();
    tbPositionCursor.Select(0, 0);
}
Private Sub OnClickMoveToStart(ByVal sender As Object, ByVal e As RoutedEventArgs)

    tbPositionCursor.Focus()
    tbPositionCursor.Select(0, 0)

End Sub

Comentarios

Para poder recibir el foco, Focusable y IsEnabled deben ser true.To be focusable, Focusable and IsEnabled must both be true.

Incluso si el elemento es válido y puede recibir el foco del Focus eventos de vista previa se pueden procesar en un árbol específico y se centran en ese elemento no se puede permitir (por ejemplo, en un control compuesto).Even if the element is focusable and valid, the Focus preview events may be processed in a specific tree, and focus on that element may not be allowed (for example, in a composite control). En tal caso, este método devuelve false.In such a case, this method returns false.

En general, el foco se controla mediante dos conceptos diferentes: foco de teclado y el foco lógico.In general, focus is controlled by two different concepts: keyboard focus and logical focus. Estos dos conceptos no son siempre los mismos.These two concepts are not always the same. Para obtener más información, consulte resumen del enfoque y Input Overview.For more information, see Focus summary and Input Overview.

Si una llamada a Focus devuelve true, IsKeyboardFocused y IsKeyboardFocusWithin también son true.If calling Focus returns true, IsKeyboardFocused and IsKeyboardFocusWithin are also true.

Si las propiedades relacionadas ya no están true, al llamar a Focus, uno o varios de los siguientes eventos se generan en el siguiente orden: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (el origen es el nuevo destino de foco), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (el origen es el nuevo destino de foco).If the related properties are not already true, when you call Focus, one or more of the following events are raised in the following order: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (source is the new focus target), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (source is the new focus target).

En orden para esta llamada se realice correctamente, de algún otro elemento en la aplicación tenía que tiene el foco anteriormente.In order for this call to be successful, some other element in the application needed to have focus previously.

Se aplica a