다음을 통해 공유

SearchBox.FocusOnKeyboardInput 속성

  • 참조

정의

네임스페이스:
Windows.UI.Xaml.Controls
편집

사용자가 앱의 아무 곳에나 입력하여 검색할 수 있는지 여부를 결정하는 값을 가져오거나 설정합니다.

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

속성 값

Boolean

bool

사용자가 앱의 아무 곳에나 입력하여 검색할 수 있으면 true입니다. 그렇지 않으면 false입니다. 기본값은 false입니다.

설명

참고

FocusOnKeyboardInput이 true로 설정된 경우 터치 키보드를 사용할 때 SearchBox 컨트롤에 중복 문자를 만드는 문제가 있습니다. 다음 단계를 수행하여 문제를 해결할 수 있습니다.

  1. SearchBox가 포커스를 받은 후 FocusOnKeyboardInput을 사용하지 않도록 설정합니다. 이렇게 하려면 PrepareForFocusOnKeyboardInput 이벤트에 등록하고 이벤트 처리기를 사용하여 FocusOnKeyboardInput을 false로 설정합니다.
  2. SearchBox에서 포커스가 끊어지면 FocusOnKeyboardInput을 다시 true로 설정합니다. 이렇게 하려면 LostFocus 이벤트에 등록하고 이벤트 처리기를 사용하여 FocusOnKeyboardInput을 다시 true로 설정합니다.

FocusOnKeyboardInput이 true이면 현재 스레드의 키보드 입력이 가로채지고 텍스트 입력이 SearchBox로 리디렉션됩니다. 텍스트 입력만 있으면 SearchBox 가 포커스를 받습니다. 화살표 또는 Tab과 같은 텍스트가 아닌 키는 SearchBox로 리디렉션되지 않습니다. WIN/CTRL/Alt 키 조합(붙여넣기용 Ctrl-V 제외)도 리디렉션되지 않습니다.

컨트롤을 표시하는 등 SearchBox에서 포커스를 설정하는 것 이상을 수행하려면 PrepareForFocusOnKeyboardInput 이벤트를 처리합니다.

사용자가 편집 가능한 다른 텍스트 필드에 포커스를 설정하는 경우 FocusOnKeyboardInput을 false 로 설정해야 합니다.

사용자가 검색을 입력하도록 허용해야 하는 경우에 대한 자세한 내용은 검색에 대한 지침 및 검사 목록을 참조하세요.

적용 대상

추가 정보