SearchBox.FocusOnKeyboardInput Proprietà
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.
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à
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:
- 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.
- 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.