SearchBox.QuerySubmitted 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
發生于使用者提交搜尋查詢時。
// Register
event_token QuerySubmitted(TypedEventHandler<SearchBox, SearchBoxQuerySubmittedEventArgs const&> const& handler) const;
// Revoke with event_token
void QuerySubmitted(event_token const* cookie) const;
// Revoke with event_revoker
SearchBox::QuerySubmitted_revoker QuerySubmitted(auto_revoke_t, TypedEventHandler<SearchBox, SearchBoxQuerySubmittedEventArgs const&> const& handler) const;
public event TypedEventHandler<SearchBox,SearchBoxQuerySubmittedEventArgs> QuerySubmitted;
function onQuerySubmitted(eventArgs) { /* Your code */ }
searchBox.addEventListener("querysubmitted", onQuerySubmitted);
searchBox.removeEventListener("querysubmitted", onQuerySubmitted);
- or -
searchBox.onquerysubmitted = onQuerySubmitted;
Public Custom Event QuerySubmitted As TypedEventHandler(Of SearchBox, SearchBoxQuerySubmittedEventArgs)
<SearchBox QuerySubmitted="eventhandler"/>
事件類型
範例
以下是 SearchBox的基本 XAML 定義,以及 QuerySubmitted 處理常式的實作。 它會呼叫 Frame.Navigate 以載入搜尋查詢結果頁面, (未顯示名為 SearchResultsPage1
的) 。 處理常式中的這個/Me參考是包含的頁面實例,如同頁面輸入事件處理常式代碼的一般。 您可以在快速入門中看到類似的程式碼 :將搜尋新增至應用程式 ,並 讓使用者在 中搜尋資訊 。
<SearchBox x:Name="mySearchBox"
FocusOnKeyboardInput="True"
QuerySubmitted="mySearchBox_QuerySubmitted"
Height="35" />
private void mySearchBox_QuerySubmitted(SearchBox sender, SearchBoxQuerySubmittedEventArgs args)
{
this.Frame.Navigate(typeof(SearchResultsPage1), args.QueryText);
}
Private Sub mySearchBox_QuerySubmitted(sender As SearchBox, args As SearchBoxQuerySubmittedEventArgs)
Me.Frame.Navigate(GetType(SearchResultsPage1), args.QueryText)
End Sub
備註
處理此事件,以便您可以從SearchBoxQuerySubmittedEventArgs取得QueryText值,並在載入搜尋結果頁面以顯示給使用者時,將其傳遞為流覽資料。
如需如何處理 QuerySubmitted 的完整範例,作為搜尋建議的完整範例的一部分,請參閱 SearchBox 控制項範例。
QuerySubmitted 的處理常式簽章會使用 TypedEventHandler ,並強制執行 sender 參數為 SearchBox 實例,而不只是 Object。