SearchSuggestionCollection.AppendResultSuggestion Méthode
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.
Ajoute un résultat de recherche suggéré à la liste des suggestions à afficher dans le volet de recherche.
public:
virtual void AppendResultSuggestion(Platform::String ^ text, Platform::String ^ detailText, Platform::String ^ tag, IRandomAccessStreamReference ^ image, Platform::String ^ imageAlternateText) = AppendResultSuggestion;void AppendResultSuggestion(winrt::hstring const& text, winrt::hstring const& detailText, winrt::hstring const& tag, IRandomAccessStreamReference const& image, winrt::hstring const& imageAlternateText);public void AppendResultSuggestion(string text, string detailText, string tag, IRandomAccessStreamReference image, string imageAlternateText);function appendResultSuggestion(text, detailText, tag, image, imageAlternateText)Public Sub AppendResultSuggestion (text As String, detailText As String, tag As String, image As IRandomAccessStreamReference, imageAlternateText As String)Paramètres
- text
-
String
Platform::String
winrt::hstring
Texte du résultat suggéré.
- detailText
-
String
Platform::String
winrt::hstring
Texte détaillé du résultat suggéré.
- tag
-
String
Platform::String
winrt::hstring
Balise unique qui identifie ce résultat suggéré.
Si ce résultat suggéré est sélectionné par l’utilisateur, un événement ResultSuggestionChosen se produit. Lorsque l’application gère cet événement, elle peut obtenir la balise de la suggestion de résultat choisie à partir de la propriété SearchPaneResultSuggestionChosenEventArgs.Tag .
Image à accompagner la suggestion de résultats. L’image doit être 40 x 40. Windows met à l’échelle ou rognera des images plus petites ou plus grandes.
- imageAlternateText
-
String
Platform::String
winrt::hstring
Texte de remplacement de l’image.
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 de 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.
Vous devez utiliser les suggestions de résultats au lieu des suggestions de requête uniquement pour afficher des résultats de haute confiance qui amènent l’utilisateur directement à l’élément au lieu d’une vue qui affiche les résultats de la recherche.
Les résultats suggérés incluent une image et un texte de détail facultatif à afficher avec la suggestion dans le volet de recherche. L’image signale à l’utilisateur qu’il voit des résultats et non des suggestions de requête. Si une image pour le résultat n’existe pas, vous pouvez utiliser une image ou une icône générique qui représente le résultat ou le type de résultat.
Vous devez écouter et gérer l’événement ResultSuggestionChosen si vous souhaitez fournir des suggestions de résultats.
Le volet de recherche peut afficher 5 suggestions, au maximum. En outre, chaque séparateur que vous utilisez remplace une suggestion et réduit le nombre de suggestions que vous pouvez afficher.