SearchSuggestionCollection.AppendResultSuggestion Metode
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.
Menambahkan hasil pencarian yang disarankan ke daftar saran untuk ditampilkan di panel pencarian.
public:
virtual void AppendResultSuggestion(Platform::String ^ text, Platform::String ^ detailText, Platform::String ^ tag, IRandomAccessStreamReference ^ image, Platform::String ^ imageAlternateText) = AppendResultSuggestion;
void AppendResultSuggestion(winrt::hstring const& text, winrt::hstring const& detailText, winrt::hstring const& tag, IRandomAccessStreamReference const& image, winrt::hstring const& imageAlternateText);
public void AppendResultSuggestion(string text, string detailText, string tag, IRandomAccessStreamReference image, string imageAlternateText);
function appendResultSuggestion(text, detailText, tag, image, imageAlternateText)
Public Sub AppendResultSuggestion (text As String, detailText As String, tag As String, image As IRandomAccessStreamReference, imageAlternateText As String)
Parameter
- text
-
String
Platform::String
winrt::hstring
Teks hasil yang disarankan.
- detailText
-
String
Platform::String
winrt::hstring
Teks detail untuk hasil yang disarankan.
- tag
-
String
Platform::String
winrt::hstring
Tag unik yang mengidentifikasi hasil yang disarankan ini.
Jika hasil yang disarankan ini dipilih oleh pengguna, peristiwa ResultSuggestionChosen terjadi. Saat aplikasi menangani peristiwa ini, aplikasi bisa mendapatkan tag saran hasil yang dipilih dari properti SearchPaneResultSuggestionChosenEventArgs.Tag .
Gambar untuk menyertai saran hasil. Gambar harus 40 x 40. Windows akan menskalakan atau memangkas gambar yang lebih kecil atau lebih besar.
- imageAlternateText
-
String
Platform::String
winrt::hstring
Teks alternatif untuk gambar.
Keterangan
Penting
Untuk mengimplementasikan pencarian di aplikasi untuk Windows 10 atau yang lebih baru, gunakan AutoSuggestBox. Lihat Kotak saran otomatis untuk informasi selengkapnya.
Anda tidak boleh menggunakan API Windows.ApplicationModel.Search (SearchPane, SearchContract
) atau SEARCHBox API di aplikasi untuk Windows 10 atau yang lebih baru.
Anda harus menggunakan saran hasil alih-alih saran kueri hanya untuk menampilkan hasil keyakinan tinggi yang membawa pengguna langsung ke item alih-alih ke tampilan yang memperlihatkan hasil pencarian.
Hasil yang disarankan mencakup gambar dan teks detail opsional untuk ditampilkan dengan saran di panel pencarian. Gambar memberi sinyal kepada pengguna bahwa mereka melihat hasil dan bukan saran kueri. Jika gambar untuk hasilnya tidak ada, Anda dapat menggunakan gambar atau ikon generik yang mewakili hasil atau jenis hasil.
Anda harus mendengarkan dan menangani peristiwa ResultSuggestionChosen jika Anda ingin memberikan saran hasil.
Panel pencarian paling banyak bisa menampilkan 5 saran. Selain itu, setiap pemisah yang Anda gunakan menggantikan saran dan menurunkan jumlah saran yang dapat Anda tampilkan.