SearchBox.SetLocalContentSuggestionSettings Method

指定基于本地文件的建议是否自动显示在搜索框建议中,并定义 Windows 使用的条件来定位和筛选这些建议。

语法


Public Sub SetLocalContentSuggestionSettings(
  settings As LocalContentSuggestionSettings 
)

参数

settings

类型: LocalContentSuggestionSettings

本地内容建议的新设置。

备注

当启用本地内容的建议时,Windows 从用户的本地文件提供搜索建议作为用户输入查询文本。例如,图片应用程序可以配置本地内容建议,以便搜索建议只来自用户的图片库中存储的特定类型的图像文件。

若要搜索本地库,必须在应用清单中声明相应的功能。有关更多信息,请参见应用程序功能声明

示例

在此,建议仅限于一种文件、音乐文件,使用 AQS 字符串。两个最常见的高级查询语法 (AQS) 筛选来限制。根据文件类型,如示例中的 kind:music;并根据文件扩展名,如 ext:.mp3。在高级查询语法中,可以详细了解 AQS。


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 8.1

最低支持服务器

Windows Server 2012 R2

命名空间

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

元数据

Windows.winmd

另请参见

SearchBox

 

 

显示:
© 2015 Microsoft