SearchBoxSuggestionsRequestedEventArgs Класс

Определение

Пространство имен:

Windows.UI.Xaml.Controls

Предоставляет данные события для события 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

Наследование

Object Platform::Object IInspectable SearchBoxSuggestionsRequestedEventArgs

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

Если вы хотите ответить на событие SuggestionsRequested асинхронно, перед изменением списка предложений необходимо получить объект SearchSuggestionsRequestDeferral . Ниже приведен пример, показывающий, как это происходит.

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

}

Комментарии

Важно!

Хотя SearchBox реализуется во всех семействах устройств, он не полностью использует свои функции в мобильных устройствах. Используйте AutoSuggestBox при выполнении любого поиска. См. раздел SearchBox заменен на AutoSuggestBox.

Свойства

Language	Возвращает тег языка Internet Engineering Task Force (IETF) (стандарт BCP 47), который идентифицирует язык, связанный в настоящее время с устройством ввода текста пользователя.
LinguisticDetails	Возвращает сведения о тексте запроса, который пользователь вводит с помощью редактора метода ввода (IME).
QueryText	Возвращает текст запроса текущего поиска.
Request	Возвращает объект , в котором хранятся предложения и сведения об этом запросе.

См. также раздел

• SuggestionsRequested