SearchBox.QuerySubmitted Ereignis

  • Referenz

Definition

Namespace:
Windows.UI.Xaml.Controls
Bearbeiten

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

TypedEventHandler<SearchBox,SearchBoxQuerySubmittedEventArgs>

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.

Gilt für:

Weitere Informationen