SearchBox.QuerySubmitted Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, wenn der Benutzer eine Suchabfrage übermittelt.
// 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"/>
Ereignistyp
Beispiele
Hier sehen Sie eine grundlegende XAML-Definition für ein SearchBox-Objekt und eine Implementierung des QuerySubmitted-Handlers. Es wird Frame.Navigate aufgerufen, um eine Suchabfrageergebnisseite (nicht angezeigt) mit dem Namen SearchResultsPage1zu laden. Die diese/Me-Referenz in den Handlern ist die enthaltende Seite instance, wie es für die Verarbeitung von On-Page-Eingabeereignissen typisch ist. Sie können einen ähnlichen Code im Rahmen der Schnellstartanleitung sehen: Hinzufügen der Suche zu einer App und Aktivieren der Benutzersuche nach Informationen in Ihrem .
<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
Hinweise
Behandeln Sie dieses Ereignis, sodass Sie den QueryText-Wert von SearchBoxQuerySubmittedEventArgs abrufen und ihn als Navigationsdaten übergeben können, wenn Sie eine Suchergebnisseite laden, die dem Benutzer angezeigt werden soll.
Ein vollständiges Beispiel für die Behandlung von QuerySubmitted als Teil eines vollständigen Beispiels, das auch Suchvorschläge ausführt, finden Sie unter SearchBox-Steuerelementbeispiel.
Die Handlersignatur für QuerySubmitted verwendet TypedEventHandler und erzwingt, dass der Senderparameter ein SearchBox-instance und nicht nur Object ist.