SearchBox.SetLocalContentSuggestionSettings Metodo

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Controls

Specifica se i suggerimenti basati sui file locali vengono visualizzati automaticamente nei suggerimenti della casella di ricerca e definiscono i criteri usati da Windows per individuare e filtrare questi suggerimenti.

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)

Parametri

settings

LocalContentSuggestionSettings

Nuove impostazioni per i suggerimenti di contenuto locale.

Esempio

In questo caso, i suggerimenti sono limitati a un tipo di file, file musicali, usando una stringa AQS. Due dei filtri AQS più comuni limitano in base al tipo di file, ad esempio "kind:music" nell'esempio; e in base all'estensione del nome di file, ad esempio "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);
}

Commenti

Quando i suggerimenti per il contenuto locale sono abilitati, Windows fornisce suggerimenti di ricerca dai file locali dell'utente quando l'utente immette testo della query. Ad esempio, un'applicazione immagine può configurare suggerimenti di contenuto locale in modo che i suggerimenti di ricerca provengano solo da un particolare tipo di file di immagine archiviato nella raccolta immagini dell'utente.

Per eseguire ricerche in una libreria locale, è necessario dichiarare la funzionalità appropriata nel manifesto dell'app. Per altre info, vedi Dichiarazioni di funzionalità delle app.