Bagikan melalui

SearchSuggestionCollection.AppendResultSuggestion Metode

  • Referensi

Definisi

Ruang nama:
Windows.ApplicationModel.Search
Edit

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 .

image
IRandomAccessStreamReference

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.

Berlaku untuk

Lihat juga