SearchBox.SetLocalContentSuggestionSettings Methode

Definition

Namespace:

Windows.UI.Xaml.Controls

Gibt an, ob Vorschläge, die auf lokalen Dateien basieren, automatisch in den Suchfeldvorschlägen angezeigt werden, und definiert die Kriterien, die Windows zum Suchen und Filtern dieser Vorschläge verwendet.

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)

Parameter

settings

LocalContentSuggestionSettings

Die neuen Einstellungen für vorschläge für lokale Inhalte.

Beispiele

Hier sind Vorschläge auf eine Art von Datei beschränkt, Musikdateien, die eine AQS-Zeichenfolge verwenden. Zwei der häufigsten AQS-Filter schränken basierend auf der Dateiart ein, z. B. "kind:music" im Beispiel; und basierend auf der Dateinamenerweiterung, z. B. "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);
}

Hinweise

Wenn Vorschläge für lokale Inhalte aktiviert sind, stellt Windows Suchvorschläge aus den lokalen Dateien des Benutzers bereit, während der Benutzer Abfragetext eingibt. Beispielsweise kann eine Bildanwendung vorschläge für lokale Inhalte konfigurieren, sodass Suchvorschläge nur aus einer bestimmten Art von Bilddatei stammen, die in der Bildbibliothek des Benutzers gespeichert ist.

Zum Durchsuchen einer lokalen Bibliothek muss die entsprechende Funktion im App-Manifest deklariert werden. Weitere Informationen finden Sie unter Deklaration der App-Funktionen.