UIElement3D.Focus Metodo

Definizione

Tenta di impostare lo stato attivo logico sull'elemento.Attempts to set the logical focus on 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 logico e da tastiera sono entrambi impostati su questo elemento; false se è stato impostato solo lo stato attivo logico.true if both logical and keyboard focus were set to this element; false if only logical focus was set.

Implementazioni

Commenti

Per essere attivabili, Focusable e IsEnabled devono essere true.To be focusable, Focusable and IsEnabled must both be true.

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.

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).

Affinché la chiamata abbia esito positivo, è necessario che un altro elemento nell'applicazione abbia lo stato attivo in precedenza.In order for this call to be successful, some other element in the application needed to have focus previously.

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 e tenta anche di impostare lo stato attivo della tastiera.This method sets the logical focus, and also attempts to set the keyboard focus. Non esiste alcun mezzo programmatico per impostare lo stato attivo della tastiera in modo specifico, a causa dell'input dell'utente.There is no programmatic means to set keyboard focus specifically, this happens due to user input. Per altre informazioni, vedere Cenni preliminari sull'input.For more information, see Input Overview.

Focus è stato introdotto nella versione .NET Framework 3,5.Focus is introduced in the .NET Framework version 3.5. Per altre informazioni, vedere Versioni e dipendenze.For more information, see Versions and Dependencies.

Si applica a