SearchSuggestionCollection.AppendResultSuggestion Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 .
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.