Compartir a través de

SearchSuggestionCollection.AppendResultSuggestion Método

  • Referencia

Definición

Espacio de nombres:
Windows.ApplicationModel.Search
Editar

Anexa un resultado de búsqueda sugerido a la lista de sugerencias que se mostrarán en el panel de búsqueda.

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

Texto del resultado sugerido.

detailText
String

Platform::String

winrt::hstring

Texto detallado del resultado sugerido.

tag
String

Platform::String

winrt::hstring

Etiqueta única que identifica este resultado sugerido.

Si el usuario selecciona este resultado sugerido, se produce un evento ResultSuggestionChosen . Cuando la aplicación controla este evento, puede obtener la etiqueta de la sugerencia de resultado elegida de la propiedad SearchPaneResultSuggestionChosenEventArgs.Tag .

image
IRandomAccessStreamReference

Imagen que se va a acompañar a la sugerencia de resultados. La imagen debe ser de 40 x 40. Windows escalará o recortará imágenes más pequeñas o más grandes.

imageAlternateText
String

Platform::String

winrt::hstring

Texto alternativo de la imagen.

Comentarios

Importante

Para implementar la búsqueda en una aplicación para Windows 10 o posterior, use AutoSuggestBox. Consulte el cuadro Sugerencias automáticas para obtener más información.

No debe usar las API Windows.ApplicationModel.Search (SearchPane, SearchContract) ni SearchBox API en aplicaciones para Windows 10 o posterior.

Debe usar sugerencias de resultados en lugar de sugerencias de consulta solo para mostrar resultados de elevada confianza que llevan al usuario directamente al elemento en lugar de a una vista que muestre los resultados de búsqueda.

Los resultados sugeridos incluyen una imagen y un texto de detalle opcional para mostrar con la sugerencia en el panel de búsqueda. La imagen indica al usuario que ve los resultados y no las sugerencias de consulta. Si no existe una imagen para el resultado, puede usar una imagen genérica o un icono que represente el resultado o el tipo de resultado.

Debe escuchar y controlar el evento ResultSuggestionChosen si desea proporcionar sugerencias de resultados.

El panel de búsqueda puede mostrar 5 sugerencias, como máximo. Además, cada separador que use tiene el lugar de una sugerencia y reduce el número de sugerencias que puede mostrar.

Se aplica a

Consulte también