ContentElement.Focus Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Tenta di impostare lo stato attivo su questo elemento.
public:
virtual bool Focus();public bool Focus ();abstract member Focus : unit -> bool
override this.Focus : unit -> boolPublic Function Focus () As BooleanRestituisce
true se lo stato attivo della tastiera può essere impostato su questo elemento, false se questa chiamata al metodo non forza lo stato attivo.
Implementazioni
Esempio
L'esempio seguente è un gestore eventi con caricamento pagina che trova un paragrafo denominato specificato nel documento e imposta lo stato attivo su di esso. I paragrafi non sono attivabili per impostazione predefinita; questo particolare paragrafo aveva uno stile applicato (non mostrato) che usava uno stile Setter per renderlo attivabile.
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 trueentrambi . Si noti che quasi tutte le ContentElement classi derivate non Focusable sono per impostazione predefinita.
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 stato attivo dell'anteprima senza consentire lo stato attivo, pertanto questo metodo restituirà 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. Questo metodo imposta lo stato attivo logico. 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. Per altre informazioni, vedere Panoramica dello stato attivo e Panoramica dell'input.
Se la chiamata restituisce Focustrue, IsKeyboardFocused e IsKeyboardFocusWithin sono anche 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), IsKeyboardFocusedChanged, IsKeyboardFocusWithinChanged, LostKeyboardFocus, GotKeyboardFocus (origine è la nuova destinazione dello stato attivo).
