SearchSuggestionManager.SuggestionsRequested Evento

Definición

Espacio de nombres:

Windows.ApplicationModel.Search.Core

Se genera cuando cambia el texto de consulta del usuario y la aplicación debe proporcionar nuevas sugerencias para mostrarse en el cuadro de búsqueda.

// Register
event_token SuggestionsRequested(TypedEventHandler<SearchSuggestionManager, SearchSuggestionsRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void SuggestionsRequested(event_token const* cookie) const;

// Revoke with event_revoker
SearchSuggestionManager::SuggestionsRequested_revoker SuggestionsRequested(auto_revoke_t, TypedEventHandler<SearchSuggestionManager, SearchSuggestionsRequestedEventArgs const&> const& handler) const;

public event TypedEventHandler<SearchSuggestionManager,SearchSuggestionsRequestedEventArgs> SuggestionsRequested;

function onSuggestionsRequested(eventArgs) { /* Your code */ }
searchSuggestionManager.addEventListener("suggestionsrequested", onSuggestionsRequested);
searchSuggestionManager.removeEventListener("suggestionsrequested", onSuggestionsRequested);
- or -
searchSuggestionManager.onsuggestionsrequested = onSuggestionsRequested;

Public Custom Event SuggestionsRequested As TypedEventHandler(Of SearchSuggestionManager, SearchSuggestionsRequestedEventArgs) 

Tipo de evento

TypedEventHandler<SearchSuggestionManager,SearchSuggestionsRequestedEventArgs>

Comentarios

Las sugerencias pueden provenir de tres orígenes: historial de búsqueda, archivos locales o de un origen especificado por la aplicación. Las sugerencias se agrupan por su origen y se muestran en el siguiente orden en el panel de búsqueda: historial de búsqueda, archivos locales y, a continuación, orígenes especificados por la aplicación.

Si la aplicación participa en el contrato de búsqueda y quieres que la aplicación muestre sugerencias de orígenes que especifiques, debes registrar un controlador para responder cuando se active este evento. En el controlador de eventos SuggestionsRequested, responda obteniendo sugerencias y rellenando SearchSuggestionCollection en función del queryText del usuario.

Nota

Si desea responder a este evento de forma asincrónica, debe obtener un aplazamiento de la propiedad Request .

No se pueden proporcionar sugerencias para un cuadro de búsqueda vacío, por lo que este evento no se genera cuando el usuario actualiza el cuadro de búsqueda para que esté vacío.

Tipos de sugerencias de búsqueda

Hay dos tipos de sugerencias que la aplicación puede mostrar: sugerencias que ayudan a los usuarios a refinar una consulta (sugerencias de consulta) y sugerencias que son resultados reales de una consulta (sugerencias de resultados). Puede optar por mostrar o ambos tipos de sugerencias.

Si proporciona sugerencias de consulta y el usuario selecciona una, la aplicación debe responder mostrando los resultados de la consulta seleccionada y refinada en la página de resultados de búsqueda de la aplicación.

Si proporciona sugerencias de resultados, también debe registrar un controlador de eventos ResultSuggestionChosen para que pueda responder cuando el usuario seleccione una de las sugerencias de resultados y pueda mostrar el resultado al usuario.

Obtención de sugerencias

Estos son algunos ejemplos de orígenes que la aplicación puede usar para obtener sugerencias:

• Desde una lista local, estática y definida por la aplicación
• Desde una dirección URL que admite sugerencias en formato OpenSearch

Mostrar sugerencias proporcionadas por la aplicación en el control del cuadro de búsqueda

Después de obtener sugerencias, las mostrará en el panel de búsqueda agregándolas a searchSuggestionCollection de la solicitud.

Si decide mostrar las sugerencias de consulta y las sugerencias de resultados, debe agrupar las sugerencias por tipo de sugerencia (consulta o resultado) y separar los grupos mediante AppendSearchSeparator. Cada separador tiene el lugar de una sugerencia y debe seguir al menos una sugerencia, lo que reduce el número de sugerencias que puede mostrar.

Consulte también

• SearchBox