SearchBoxSuggestionsRequestedEventArgs Clase

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Proporciona datos de eventos para el evento SearchBox.SuggestionsRequested .

public ref class SearchBoxSuggestionsRequestedEventArgs sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchBoxSuggestionsRequestedEventArgs final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchBoxSuggestionsRequestedEventArgs

Public NotInheritable Class SearchBoxSuggestionsRequestedEventArgs

Herencia

Object Platform::Object IInspectable SearchBoxSuggestionsRequestedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Si desea responder al evento SuggestionsRequested de forma asincrónica, debe obtener un objeto SearchSuggestionsRequestDeferral antes de editar la lista de sugerencias. Este es un ejemplo que muestra cómo.

public async static void SearchBox_SuggestionsRequested(
    SearchBox sender, 
    SearchBoxSuggestionsRequestedEventArgs args)
{

    // This object lets us edit the SearchSuggestionCollection asynchronously. 
    var deferral = args.Request.GetDeferral();

    try { 

        // Retrieve the system-supplied suggestions.
        var suggestions = args.Request.SearchSuggestionCollection;

        var groups = await SampleDataSource.GetGroupsAsync();
        foreach (var group in groups)
        {
            var matchingItems = group.Items.Where(
                item => item.Title.StartsWith(
                    args.QueryText, StringComparison.CurrentCultureIgnoreCase));

            foreach (var item in matchingItems)
            {
                suggestions.AppendQuerySuggestion(item.Title);
            }
        }

        foreach (string alternative in args.LinguisticDetails.QueryTextAlternatives)
        {
            if (alternative.StartsWith(
                args.QueryText, StringComparison.CurrentCultureIgnoreCase))
            {
                suggestions.AppendQuerySuggestion(alternative); 
            }
        }
    }
    finally {
        deferral.Complete();
    }

}

Comentarios

Importante

Aunque SearchBox se implementa en la familia de dispositivos universales, no es totalmente funcional en dispositivos móviles. Usa AutoSuggestBox para tu experiencia de búsqueda universal. Consulta SearchBox en desuso en favor de AutoSuggestBox.

Propiedades

Language	Obtiene la etiqueta de idioma del Grupo de tareas de ingeniería de Internet (IETF) (estándar BCP 47) que identifica el idioma asociado actualmente al dispositivo de entrada de texto del usuario.
LinguisticDetails	Obtiene información sobre el texto de consulta que el usuario escribe a través de un Editor de métodos de entrada (IME).
QueryText	Obtiene el texto de consulta de la búsqueda actual.
Request	Obtiene el objeto que almacena las sugerencias e información sobre esta solicitud.

Consulte también

• SuggestionsRequested