SearchBox.SetLocalContentSuggestionSettings Metode

Definisi

Ruang nama:

Windows.UI.Xaml.Controls

Menentukan apakah saran berdasarkan file lokal secara otomatis ditampilkan dalam saran kotak pencarian, dan menentukan kriteria yang digunakan Windows untuk menemukan dan memfilter saran ini.

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

Pengaturan baru untuk saran konten lokal.

Contoh

Di sini, saran dibatasi untuk satu jenis file, file musik, menggunakan string AQS. Dua filter AQS yang paling umum membatasi berdasarkan jenis file, seperti "kind:music" dalam contoh; dan berdasarkan ekstensi nama file, seperti "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);
}

Keterangan

Ketika saran konten lokal diaktifkan, Windows menyediakan saran pencarian dari file lokal pengguna saat pengguna memasukkan teks kueri. Misalnya, aplikasi gambar dapat mengonfigurasi saran konten lokal sehingga saran pencarian hanya berasal dari jenis file gambar tertentu yang disimpan di pustaka gambar pengguna.

Untuk mencari pustaka lokal, kemampuan yang sesuai harus dideklarasikan dalam manifes aplikasi. Untuk informasi selengkapnya, lihat Deklarasi kemampuan aplikasi.