Partager via

SearchSuggestionCollection.AppendResultSuggestion Méthode

  • Référence

Définition

Espace de noms:
Windows.ApplicationModel.Search
Modifier

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
IRandomAccessStreamReference

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.

S’applique à

Voir aussi