SearchBox.SetLocalContentSuggestionSettings Méthode

Définition

Espace de noms:

Windows.UI.Xaml.Controls

Spécifie si les suggestions basées sur des fichiers locaux sont automatiquement affichées dans les suggestions de zone de recherche et définit les critères que Windows utilise pour localiser et filtrer ces suggestions.

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)

Paramètres

settings

LocalContentSuggestionSettings

Nouveaux paramètres pour les suggestions de contenu local.

Exemples

Ici, les suggestions sont limitées à un type de fichier, des fichiers de musique, à l’aide d’une chaîne AQS. Deux des filtres AQS les plus courants restreignent en fonction du type de fichier, comme « kind:music » dans l’exemple ; et basée sur l’extension de nom de fichier, comme « 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);
}

Remarques

Lorsque les suggestions de contenu local sont activées, Windows fournit des suggestions de recherche à partir des fichiers locaux de l’utilisateur à mesure que l’utilisateur entre le texte de la requête. Par exemple, une application image peut configurer des suggestions de contenu local afin que les suggestions de recherche proviennent uniquement d’un type particulier de fichier image stocké dans la bibliothèque d’images de l’utilisateur.

Pour effectuer une recherche dans une bibliothèque locale, la fonctionnalité appropriée doit être déclarée dans le manifeste de l’application. Pour plus d’informations, voir Déclarations des fonctionnalités d’application.