Partilhar via


SearchBox.FocusOnKeyboardInput Propriedade

Definição

Obtém ou define um valor que determina se um usuário pode pesquisar digitando em qualquer lugar do aplicativo.

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"/>

Valor da propriedade

Boolean

bool

true se o usuário puder pesquisar digitando em qualquer lugar do aplicativo; caso contrário, false. O padrão é false.

Comentários

Observação

Quando FocusOnKeyboardInput é definido como true, há um problema que às vezes cria caracteres duplicados no controle SearchBox ao usar o teclado virtual. Você pode contornar o problema seguindo estas etapas:

  1. Desabilite FocusOnKeyboardInput depois que a SearchBox receber o foco. Para fazer isso, registre-se no evento PrepareForFocusOnKeyboardInput e use o manipulador de eventos para definir FocusOnKeyboardInput como false.
  2. Quando a SearchBox perder o foco, defina FocusOnKeyboardInput de volta como true. Para fazer isso, registre-se no evento LostFocus e use o manipulador de eventos para definir FocusOnKeyboardInput de volta como true.

Quando FocusOnKeyboardInput é true, a entrada de teclado no thread atual é interceptada e a entrada textual é redirecionada para a SearchBox. Somente a entrada textual fará com que a SearchBox receba o foco. As teclas que não são de texto, como setas ou Tab, não são redirecionadas para o SearchBox. As combinações de teclas WIN/CTRL/ALT (exceto Ctrl-V para colar) também não são redirecionadas.

Para fazer mais do que apenas definir o foco na SearchBox, como tornar o controle visível, manipule o evento PrepareForFocusOnKeyboardInput .

Você deverá definir FocusOnKeyboardInput como false se o usuário definir o foco em algum outro campo de texto editável.

Para saber mais sobre quando você deve permitir que os usuários digitem para pesquisar, consulte Diretrizes e lista de verificação para pesquisa.

Aplica-se a

Confira também