SearchBox.FocusOnKeyboardInput Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Ottiene o imposta un valore che determina se un utente può eseguire la ricerca digitando in qualsiasi punto dell'app.

public:
 property bool FocusOnKeyboardInput { bool get(); void set(bool value); };

bool FocusOnKeyboardInput();

void FocusOnKeyboardInput(bool value);

public bool FocusOnKeyboardInput { get; set; }

var boolean = searchBox.focusOnKeyboardInput;
searchBox.focusOnKeyboardInput = boolean;

Public Property FocusOnKeyboardInput As Boolean

<SearchBox FocusOnKeyboardInput="bool"/>

Valore della proprietà

Boolean

bool

true se l'utente può cercare digitando in qualsiasi punto dell'app; in caso contrario, false. Il valore predefinito è false.

Commenti

Nota

Quando FocusOnKeyboardInput è impostato su true, si verifica un problema che talvolta crea caratteri duplicati nel controllo SearchBox quando si usa la tastiera virtuale. Per risolvere il problema, seguire questa procedura:

1. Disabilitare FocusOnKeyboardInput dopo che searchBox riceve lo stato attivo. A tale scopo, eseguire la registrazione per l'evento PrepareForFocusOnKeyboardInput e usare il gestore eventi per impostare FocusOnKeyboardInput su false.
2. Quando SearchBox perde lo stato attivo, imposta FocusOnKeyboardInput su true. A tale scopo, registrarsi per l'evento LostFocus e usare il gestore eventi per impostare FocusOnKeyboardInput su true.

Quando FocusOnKeyboardInput è true, l'input della tastiera nel thread corrente viene intercettato e l'input testuale viene reindirizzato a SearchBox. Solo l'input testuale fa sì che searchBox riceva lo stato attivo. I tasti non di testo, ad esempio frecce o tabulazioni, non vengono reindirizzati al controllo SearchBox. Le combinazioni di tasti WIN/CTRL/ALT (ad eccezione di CTRL-V per incolla) non vengono reindirizzate.

Per fare di più che impostare lo stato attivo in SearchBox, ad esempio rendere visibile il controllo, gestire l'evento PrepareForFocusOnKeyboardInput .

È consigliabile impostare FocusOnKeyboardInput su false se l'utente imposta lo stato attivo su un altro campo di testo modificabile.

Per altre informazioni sui casi in cui è consigliabile consentire agli utenti di digitare la ricerca, vedere Linee guida ed elenco di controllo per la ricerca.

Vedi anche

• PrepareForFocusOnKeyboardInput
• Linee guida ed elenco di controllo per la ricerca