SearchBox.QuerySubmitted Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Se produit lorsque l’utilisateur envoie une requête de recherche.
// 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"/>
Type d'événement
Exemples
Voici une définition XAML de base pour un SearchBox et une implémentation du gestionnaire QuerySubmitted. Il appelle Frame.Navigate pour charger une page de résultats de requête de recherche (non affichée) nommée SearchResultsPage1
. La référence ce/me dans les gestionnaires est le instance de page contenant, comme c’est généralement le cas pour le code de gestion des événements d’entrée sur page. Vous pouvez voir du code similaire dans le cadre de Démarrage rapide : Ajout d’une recherche à une application et Activation des utilisateurs pour rechercher des informations dans votre .
<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
Remarques
Gérez cet événement afin que vous puissiez obtenir la valeur QueryText à partir de SearchBoxQuerySubmittedEventArgs et la transmettre en tant que données de navigation lorsque vous chargez une page de résultats de recherche à afficher à l’utilisateur.
Pour obtenir un exemple complet de gestion de QuerySubmitted dans le cadre d’un exemple complet qui effectue également des suggestions de recherche, consultez Exemple de contrôle SearchBox.
La signature du gestionnaire pour QuerySubmitted utilise TypedEventHandler et impose que le paramètre de l’expéditeur soit un instance SearchBox, pas seulement Object.