ContentElement.Focus ContentElement.Focus ContentElement.Focus ContentElement.Focus Method

Definizione

Tenta di impostare lo stato attivo su questo 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

Restituisce

true se lo stato attivo della tastiera può essere impostato su questo elemento, false se questa chiamata al metodo non forza lo stato attivo.true if keyboard focus could be set to this element; false if this method call did not force focus.

Implementazioni

Esempi

Nell'esempio seguente è un gestore di eventi di caricamento pagina che consente di trovare un determinato paragrafo nel documento denominato e imposta lo stato attivo a esso.The following example is a page-loaded event handler that finds a specified named paragraph in the document and sets focus to it. I paragrafi non sono attivabili per impostazione predefinita. Questa particolare paragrafo è stato applicato uno stile (non mostrato) che utilizzato uno stile Setter per renderla attivabile.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

Commenti

Per essere attivabile, Focusable e IsEnabled devono essere entrambi true.To be focusable, Focusable and IsEnabled must both be true. Si noti che quasi tutte le ContentElement alle classi derivate non sono Focusable per impostazione predefinita.Note that nearly all ContentElement derived classes are not Focusable by default.

Anche se un elemento è la gestione degli eventi con stato attivabile e abilitato, all'interno di una struttura ad albero specifico, (ad esempio per un controllo composito) potrebbe rispondere agli eventi dello stato attivo di anteprima, non consentendo lo stato attivo, pertanto questo metodo restituirà false.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.

In generale, lo stato attivo è disciplinato dalle due concetti distinti: della tastiera e lo stato attivo logico, che non sono sempre identici.Focus in general is governed by two separate concepts: keyboard focus and logical focus, which are not always identical. Questo metodo imposta lo stato attivo logico.This method sets the logical focus. Non c'è alcun mezzo a livello di codice per impostare lo stato attivo della tastiera specificamente; lo stato attivo della tastiera è determinato dall'input dell'utente.There is no programmatic means to set keyboard focus specifically; keyboard focus is determined by user input. Per altre informazioni, vedere Panoramica di messa a fuoco e Cenni preliminari sull'Input.For more information, see Focus Overview and Input Overview.

Se il chiamante Focus restituisce true, IsKeyboardFocused e IsKeyboardFocusWithin sono anche true.If calling Focus returns true, IsKeyboardFocused and IsKeyboardFocusWithin are also true.

Se le proprietà correlate non sono già true, quando si chiama Focus, uno o più dei seguenti eventi vengono generati nell'ordine seguente: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (l'origine è la nuova destinazione di messa a fuoco), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (l'origine è la nuova destinazione di messa a fuoco).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).

Si applica a

Vedi anche