SearchBoxSuggestionsRequestedEventArgs Classe

Definição

Namespace:

Windows.UI.Xaml.Controls

Fornece dados de evento para o 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

Herança

Object Platform::Object IInspectable SearchBoxSuggestionsRequestedEventArgs

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Se você quiser responder ao evento SuggestionsRequested de forma assíncrona, deverá obter um objeto SearchSuggestionsRequestDeferral antes de editar a lista de sugestões. Aqui está um exemplo que mostra como.

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();
    }

}

Comentários

Importante

Embora SearchBox seja implementado na família de dispositivos Universal, não é totalmente funcional em dispositivos móveis. Use AutoSuggestBox para a sua experiência de pesquisa universal. Veja SearchBox preterido em favor do AutoSuggestBox.

Propriedades

Language	Obtém a marca de idioma IETF (Internet Engineering Task Force) (padrão BCP 47) que identifica o idioma atualmente associado ao dispositivo de entrada de texto do usuário.
LinguisticDetails	Obtém informações sobre o texto da consulta que o usuário insere por meio de um IME (Editor de Método de Entrada).
QueryText	Obtém o texto da consulta da pesquisa atual.
Request	Obtém o objeto que armazena as sugestões e informações sobre essa solicitação.

Confira também

• SuggestionsRequested