SearchSuggestionCollection.AppendResultSuggestion Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Aggiunge un risultato di ricerca suggerito all'elenco di suggerimenti da visualizzare nel riquadro di ricerca.
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)Parametri
- text
-
String
Platform::String
winrt::hstring
Testo del risultato suggerito.
- detailText
-
String
Platform::String
winrt::hstring
Testo di dettaglio per il risultato suggerito.
- tag
-
String
Platform::String
winrt::hstring
Tag univoco che identifica il risultato suggerito.
Se questo risultato suggerito viene selezionato dall'utente, si verifica un evento ResultSuggestionChosen . Quando l'app gestisce questo evento, può ottenere il tag del suggerimento di risultato scelto dalla proprietà SearchPaneResultSuggestionChosenEventArgs.Tag .
Immagine che accompagna il suggerimento dei risultati. L'immagine deve essere 40 x 40. Windows ridimensiona o ritaglia immagini più piccole o più grandi.
- imageAlternateText
-
String
Platform::String
winrt::hstring
Testo alternativo per l'immagine.
Commenti
Importante
Per implementare la ricerca in un'app per Windows 10 o versione successiva, usare AutoSuggestBox. Per altre informazioni, vedi Casella di suggerimento automatico .
Non è consigliabile usare le API Windows.ApplicationModel.Search (SearchPane, SearchContract) o SearchBox nelle app per Windows 10 o versioni successive.
È consigliabile usare i suggerimenti dei risultati anziché i suggerimenti per la query solo per visualizzare risultati con attendibilità elevata che portano l'utente direttamente all'elemento anziché a una visualizzazione che mostra i risultati della ricerca.
I risultati suggeriti includono un'immagine e un testo di dettaglio facoltativo da visualizzare con il suggerimento nel riquadro di ricerca. L'immagine segnala all'utente che visualizza i risultati e non i suggerimenti per le query. Se non esiste un'immagine per il risultato, è possibile usare un'immagine o un'icona generica che rappresenta il risultato o il tipo di risultato.
Se si desidera fornire suggerimenti per i risultati, è necessario ascoltare e gestire l'evento ResultSuggestionChosen .
Il riquadro di ricerca può visualizzare al massimo 5 suggerimenti. Inoltre, ogni separatore usato assume il posto di un suggerimento e riduce il numero di suggerimenti che è possibile visualizzare.