SearchBox.SetLocalContentSuggestionSettings Método

Definição

Namespace:

Windows.UI.Xaml.Controls

Especifica se as sugestões baseadas em arquivos locais são exibidas automaticamente nas sugestões da caixa de pesquisa e define os critérios que o Windows usa para localizar e filtrar essas sugestões.

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)

Parâmetros

settings

LocalContentSuggestionSettings

As novas configurações para sugestões de conteúdo local.

Exemplos

Aqui, as sugestões são restritas a um tipo de arquivo, arquivos de música, usando uma cadeia de caracteres do AQS. Dois dos filtros AQS mais comuns restringem com base no tipo de arquivo, como "kind:music" no exemplo; e com base na extensão de nome de arquivo, como "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);
}

Comentários

Quando as sugestões de conteúdo local estão habilitadas, o Windows fornece sugestões de pesquisa dos arquivos locais do usuário à medida que o usuário insere o texto da consulta. Por exemplo, um aplicativo de imagem pode configurar sugestões de conteúdo local para que as sugestões de pesquisa venham apenas de um tipo específico de arquivo de imagem armazenado na biblioteca de imagens do usuário.

Para pesquisar uma biblioteca local, a funcionalidade apropriada deve ser declarada no manifesto do aplicativo. Para saber mais, consulte Declarações de funcionalidades do aplicativo.