SearchSuggestionCollection.AppendResultSuggestion Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 .
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.