SearchPane.ResultSuggestionChosen É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 déclenche lorsque l’utilisateur sélectionne l’un des résultats suggérés fournis par l’application et affichés dans le volet de recherche.
/// [add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
/// [remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
// Register
event_token ResultSuggestionChosen(TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs const&> const& handler) const;
// Revoke with event_token
void ResultSuggestionChosen(event_token const* cookie) const;
// Revoke with event_revoker
SearchPane::ResultSuggestionChosen_revoker ResultSuggestionChosen(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs const&> const& handler) const;/// [add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
/// [remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
// Register
event_token ResultSuggestionChosen(TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs const&> const& handler) const;
// Revoke with event_token
void ResultSuggestionChosen(event_token const* cookie) const;
// Revoke with event_revoker
SearchPane::ResultSuggestionChosen_revoker ResultSuggestionChosen(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneResultSuggestionChosenEventArgs const&> const& handler) const;[add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
[remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
public event TypedEventHandler<SearchPane,SearchPaneResultSuggestionChosenEventArgs> ResultSuggestionChosen;[add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
[remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public event TypedEventHandler<SearchPane,SearchPaneResultSuggestionChosenEventArgs> ResultSuggestionChosen;function onResultSuggestionChosen(eventArgs) { /* Your code */ }
searchPane.addEventListener("resultsuggestionchosen", onResultSuggestionChosen);
searchPane.removeEventListener("resultsuggestionchosen", onResultSuggestionChosen);
- or -
searchPane.onresultsuggestionchosen = onResultSuggestionChosen;Public Custom Event ResultSuggestionChosen As TypedEventHandler(Of SearchPane, SearchPaneResultSuggestionChosenEventArgs) Type d'événement
- Attributs
Remarques
Important
Pour implémenter la recherche dans une application pour Windows 10 ou une version ultérieure, utilisez AutoSuggestBox. Pour plus d’informations, consultez la zone Suggestion automatique.
Vous ne devez pas utiliser les API Windows.ApplicationModel.Search (SearchPane, SearchContract) ou les API SearchBox dans les applications pour Windows 10 ou une version ultérieure.
Notes
Une application ne peut pas utiliser à la fois la zone de recherche (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) et le SearchPane. L’utilisation de la zone de recherche et du volet de recherche dans la même application entraîne la levée d’une exception avec ce message : « Impossible de créer instance de type 'Windows.UI.Xaml.Controls.SearchBox.' »
Si votre application participe au contrat de recherche et affiche des suggestions de résultats possibles dans le volet de recherche, vous devez inscrire un gestionnaire d’événements pour répondre lorsque cet événement se déclenche. Dans votre gestionnaire d’événements ResultSuggestionChosen, répondez en obtenant le SearchPaneResultSuggestionChosenEventArgs. Balise du résultat choisi et utilisation de celle-ci pour amener l’utilisateur au résultat dans l’interface utilisateur de votre application.
Notes
Si vous souhaitez afficher des suggestions de résultats, vous devez également écouter et gérer l’événement SuggestionsRequested .