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。 除了 Ctrl-V 貼上) 以外，WIN/CTRL/ALT 按鍵組合 (也不會重新導向。

若要不只是在 SearchBox中設定焦點，例如讓控制項可見，請處理 PrepareForFocusOnKeyboardInput 事件。

如果使用者將焦點設定為其他可編輯的文字欄位，您應該將 FocusOnKeyboardInput 設定為 false 。

若要深入瞭解何時應該讓使用者輸入搜尋，請參閱 搜尋的指導方針和檢查清單。

另請參閱

• PrepareForFocusOnKeyboardInput
• 搜尋的指導方針和檢查清單