ContentElement.Focus ContentElement.Focus ContentElement.Focus ContentElement.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

true si el foco del teclado se pudo establecer en este elemento; false si esta llamada al método no forzó el foco.true if keyboard focus could be set to this element; false if this method call did not force focus.

Implementaciones

Ejemplos

El ejemplo siguiente es un controlador de eventos de carga de página que busca un párrafo con nombre especificado en el documento y establece el foco en él.The following example is a page-loaded event handler that finds a specified named paragraph in the document and sets focus to it. Los párrafos no pueden recibir el foco de forma predeterminada; este párrafo en particular tenía un estilo aplicado (no mostrado) que usaba un Setter estilo para que pueda recibir el foco.Paragraphs are not focusable by default; this particular paragraph had a style applied (not shown) that used a style Setter to make it focusable.

void FocusOnParagraph(object sender, RoutedEventArgs e)
{
  ContentElement ce = this.FindName("focusableP") as ContentElement;
  ce.Focus();
}
Private Sub FocusOnParagraph(ByVal sender As Object, ByVal e As RoutedEventArgs)
  Dim ce As ContentElement = TryCast(Me.FindName("focusableP"), ContentElement)
  ce.Focus()
End Sub

Comentarios

Para poder recibir el foco Focusable y IsEnabled deben ser trueambos.To be focusable, Focusable and IsEnabled must both be true. Tenga en cuenta que ContentElement casi todas las clases Focusable derivadas no están de forma predeterminada.Note that nearly all ContentElement derived classes are not Focusable by default.

Incluso si un elemento puede recibir el foco y está habilitado, el control de eventos dentro de un árbol específico (por ejemplo, para un control compuesto) podría responder a los eventos de foco de vista previa no permitiendo falseel foco, por lo que este método devolvería.Even if an element is focusable and enabled, event handling within a specific tree, (such as for a composite control) might respond to the preview focus events by not allowing focus there, thus this method would return false.

El foco en general se rige por dos conceptos independientes: el foco de teclado y el foco lógico, que no son siempre idénticos.Focus in general is governed by two separate concepts: keyboard focus and logical focus, which are not always identical. Este método establece el foco lógico.This method sets the logical focus. No hay ningún medio de programación para establecer el foco de teclado específicamente. el foco de teclado viene determinado por la entrada del usuario.There is no programmatic means to set keyboard focus specifically; keyboard focus is determined by user input. Para obtener más información, vea información General sobre el foco e información General sobre los datos.For more information, see Focus Overview and Input Overview.

Si la Focus llamada truea IsKeyboardFocused devuelve IsKeyboardFocusWithin , y tambiéntrueson.If calling Focus returns true, IsKeyboardFocused and IsKeyboardFocusWithin are also true.

Si las propiedades relacionadas no están ya true, cuando se llama Focusa, se generan uno o varios de los siguientes eventos en el orden siguiente PreviewLostKeyboardFocus: PreviewGotKeyboardFocus , (el origen es el nuevo destino del IsKeyboardFocusedChangedfoco IsKeyboardFocusWithinChanged),,, LostKeyboardFocus ,GotKeyboardFocus (el origen es el nuevo destino del 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).

Se aplica a

Consulte también: