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 パラメーターが Object だけでなく SearchBox インスタンスであることを強制 します。