SearchBox.QuerySubmitted イベント

  • リファレンス

定義

名前空間:
Windows.UI.Xaml.Controls
編集

ユーザーが検索クエリを送信したときに発生します。

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

イベントの種類

TypedEventHandler<SearchBox,SearchBoxQuerySubmittedEventArgs>

例

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 インスタンスであることを強制 します。

適用対象

こちらもご覧ください