Compartilhar via

SearchSuggestionCollection.AppendResultSuggestion Método

  • Referência

Definição

Namespace:
Windows.ApplicationModel.Search
Editar

Acrescenta um resultado de pesquisa sugerido à lista de sugestões a serem exibidas no painel de pesquisa.

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)

Parâmetros

text
String

Platform::String

winrt::hstring

O texto do resultado sugerido.

detailText
String

Platform::String

winrt::hstring

O texto detalhado do resultado sugerido.

tag
String

Platform::String

winrt::hstring

A marca exclusiva que identifica esse resultado sugerido.

Se esse resultado sugerido for selecionado pelo usuário, ocorrerá um evento ResultSuggestionChosen . Quando o aplicativo manipula esse evento, ele pode obter a marca da sugestão de resultado escolhida da propriedade SearchPaneResultSuggestionChosenEventArgs.Tag .

image
IRandomAccessStreamReference

A imagem para acompanhar a sugestão de resultados. A imagem deve ser 40 x 40. O Windows dimensionará ou cortará imagens menores ou maiores.

imageAlternateText
String

Platform::String

winrt::hstring

O texto alternativo para a imagem.

Comentários

Importante

Para implementar a pesquisa em um aplicativo para Windows 10 ou posterior, use AutoSuggestBox. Confira Caixa de sugestão automática para obter mais informações.

Você não deve usar APIs Windows.ApplicationModel.Search (SearchPane, SearchContract) ou APIs SearchBox em aplicativos para Windows 10 ou posterior.

Você deve usar sugestões de resultados em vez de sugestões de consulta apenas para exibir resultados de alta confiança que levam o usuário diretamente para o item em vez de para uma exibição que mostra os resultados da pesquisa.

Os resultados sugeridos incluem uma imagem e um texto de detalhe opcional a ser exibido com a sugestão no painel de pesquisa. A imagem sinaliza ao usuário que ele está vendo resultados e não sugestões de consulta. Se uma imagem para o resultado não existir, você poderá usar uma imagem ou ícone genérico que represente o resultado ou o tipo de resultado.

Você deve escutar e manipular o evento ResultSuggestionChosen se quiser fornecer sugestões de resultados.

O painel de pesquisa pode exibir no máximo cinco sugestões. Além disso, cada separador usado assume o lugar de uma sugestão e reduz o número de sugestões que você pode exibir.

Aplica-se a

Confira também