SearchBoxSuggestionsRequestedEventArgs Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan data peristiwa untuk peristiwa SearchBox.SuggestionsRequested .
public ref class SearchBoxSuggestionsRequestedEventArgs sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SearchBoxSuggestionsRequestedEventArgs final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SearchBoxSuggestionsRequestedEventArgs final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class SearchBoxSuggestionsRequestedEventArgs
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SearchBoxSuggestionsRequestedEventArgs
Public NotInheritable Class SearchBoxSuggestionsRequestedEventArgs
- Warisan
- Atribut
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Jika Anda ingin menanggapi peristiwa SuggestionsRequested secara asinkron, Anda harus mendapatkan objek SearchSuggestionsRequestDeferral sebelum mengedit daftar saran. Berikut adalah contoh yang menunjukkan caranya.
public async static void SearchBox_SuggestionsRequested(
SearchBox sender,
SearchBoxSuggestionsRequestedEventArgs args)
{
// This object lets us edit the SearchSuggestionCollection asynchronously.
var deferral = args.Request.GetDeferral();
try {
// Retrieve the system-supplied suggestions.
var suggestions = args.Request.SearchSuggestionCollection;
var groups = await SampleDataSource.GetGroupsAsync();
foreach (var group in groups)
{
var matchingItems = group.Items.Where(
item => item.Title.StartsWith(
args.QueryText, StringComparison.CurrentCultureIgnoreCase));
foreach (var item in matchingItems)
{
suggestions.AppendQuerySuggestion(item.Title);
}
}
foreach (string alternative in args.LinguisticDetails.QueryTextAlternatives)
{
if (alternative.StartsWith(
args.QueryText, StringComparison.CurrentCultureIgnoreCase))
{
suggestions.AppendQuerySuggestion(alternative);
}
}
}
finally {
deferral.Complete();
}
}
Keterangan
Penting
Meskipun SearchBox diimplementasikan dalam keluarga perangkat Universal, itu tidak berfungsi penuh pada perangkat seluler. Gunakan AutoSuggestBox untuk pengalaman pencarian universal Anda. Lihat SearchBox tidak digunakan lagi demi AutoSuggestBox.
Properti
Language |
Mendapatkan tag bahasa Internet Engineering Task Force (IETF) (standar BCP 47) yang mengidentifikasi bahasa yang saat ini terkait dengan perangkat input teks pengguna. |
LinguisticDetails |
Mendapatkan informasi tentang teks kueri yang dimasukkan pengguna melalui Editor Metode Input (IME). |
QueryText |
Mendapatkan teks kueri dari pencarian saat ini. |
Request |
Mendapatkan objek yang menyimpan saran dan informasi tentang permintaan ini. |