ContentElement.Focus Metodo

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 viene utilizzato un gestore eventi caricato dalla pagina che trova un paragrafo specificato nel documento e imposta lo stato attivo su di 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; Questo particolare paragrafo aveva uno stile applicato (non visualizzato) che usava uno stile Setter per renderlo 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 attivabili, Focusable e IsEnabled devono essere true.To be focusable, Focusable and IsEnabled must both be true. Si noti che quasi tutte le classi derivate ContentElement non sono Focusable per impostazione predefinita.Note that nearly all ContentElement derived classes are not Focusable by default.

Anche se un elemento è attivabile e abilitato, la gestione degli eventi all'interno di un albero specifico, ad esempio per un controllo composito, potrebbe rispondere agli eventi di anteprima dello stato attivo senza consentire 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.

Lo stato attivo in generale è regolato da due concetti distinti: lo stato attivo 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 esiste alcun mezzo programmatico per impostare lo stato attivo della tastiera in modo specifico; 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 Cenni preliminari sullo stato attivo e Cenni preliminari sull'input.For more information, see Focus Overview and Input Overview.

Se la chiamata a Focus restituisce true, vengono trueanche IsKeyboardFocused e IsKeyboardFocusWithin.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ù degli eventi seguenti vengono generati nell'ordine seguente: PreviewLostKeyboardFocus, PreviewGotKeyboardFocus (l'origine è la nuova destinazione dello stato attivo), IsKeyboardFocusedChangedIsKeyboardFocusWithinChanged, LostKeyboardFocusGotKeyboardFocus (l'origine è la nuova destinazione dello stato attivo).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