SearchBox.FocusOnKeyboardInput Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui détermine si un utilisateur peut effectuer une recherche en tapant n’importe où dans l’application.
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"/>
Valeur de propriété
bool
true si l’utilisateur peut effectuer une recherche en tapant n’importe où dans l’application ; sinon, false. La valeur par défaut est false.
Remarques
Notes
Lorsque FocusOnKeyboardInput a la valeur true, il existe un problème qui crée parfois des caractères en double dans le contrôle SearchBox lors de l’utilisation du clavier tactile. Vous pouvez contourner le problème en procédant comme suit :
- Désactivez FocusOnKeyboardInput une fois que SearchBox a reçu le focus. Pour ce faire, inscrivez-vous à l’événement PrepareForFocusOnKeyboardInput et utilisez le gestionnaire d’événements pour définir FocusOnKeyboardInput sur false.
- Lorsque searchBox perd le focus, définissez FocusOnKeyboardInput sur true. Pour ce faire, inscrivez-vous à l’événement LostFocus et utilisez le gestionnaire d’événements pour revenir à FocusOnKeyboardInput sur true.
Lorsque FocusOnKeyboardInput a la valeur true, l’entrée du clavier sur le thread actuel est interceptée et l’entrée textuelle est redirigée vers searchBox. Seule une entrée textuelle entraîne le focus sur SearchBox . Les touches non textuelles, telles que les flèches ou tabulation, ne sont pas redirigées vers searchBox. Les combinaisons de touches WIN/CTRL/ALT (à l’exception de Ctrl-V pour coller) ne sont pas non plus redirigées.
Pour ne pas simplement définir le focus dans searchBox, par exemple pour rendre le contrôle visible, gérez l’événement PrepareForFocusOnKeyboardInput .
Vous devez définir FocusOnKeyboardInput sur false si l’utilisateur définit le focus sur un autre champ de texte modifiable.
Pour en savoir plus sur le moment où vous devez autoriser les utilisateurs à effectuer une recherche, consultez Recommandations et liste de contrôle pour la recherche.