SearchBox.SetLocalContentSuggestionSettings Метод

Определение

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

Windows.UI.Xaml.Controls

Указывает, будут ли предложения, основанные на локальных файлах, автоматически отображаться в предложениях в поле поиска, и определяет критерии, которые Windows использует для поиска и фильтрации этих предложений.

public:
 virtual void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings ^ settings) = SetLocalContentSuggestionSettings;

void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings const& settings);

public void SetLocalContentSuggestionSettings(LocalContentSuggestionSettings settings);

function setLocalContentSuggestionSettings(settings)

Public Sub SetLocalContentSuggestionSettings (settings As LocalContentSuggestionSettings)

Параметры

settings

LocalContentSuggestionSettings

Новые параметры для предложений локального содержимого.

Примеры

Здесь предложения ограничиваются одним типом файлов, музыкальных файлов, использующих строку AQS. Два наиболее распространенных фильтра AQS ограничиваются в зависимости от типа файла, например kind:music в примере; и на основе расширения имени файла, например "ext:.mp3".

public MainPage()
{
    this.InitializeComponent();

    // Let Windows provide suggestions from local files.
    var settings = new Windows.ApplicationModel.Search.LocalContentSuggestionSettings();
    settings.Enabled = true;
    // Access to the music library requires that the Music Library capability
    // be declared in the app manifest .
    settings.Locations.Add(Windows.Storage.KnownFolders.MusicLibrary);
    settings.AqsFilter = "kind:Music";
    MySearchBox.SetLocalContentSuggestionSettings(settings);
}

Комментарии

Если предложения локального содержимого включены, Windows предоставляет предложения поиска из локальных файлов пользователя, когда пользователь вводит текст запроса. Например, приложение для изображений может настроить предложения локального содержимого таким образом, чтобы предложения поиска поступают только из определенного типа файла изображений, хранящегося в библиотеке изображений пользователя.

Для поиска в локальной библиотеке в манифесте приложения должна быть объявлена соответствующая возможность. Подробнее см. в разделе Объявления характеристик приложения;