Condividi tramite

SearchSuggestionCollection.AppendResultSuggestion Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Windows.ApplicationModel.Search
Modifica

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 .

image
IRandomAccessStreamReference

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.

Si applica a

Vedi anche