SearchPane.SuggestionsRequested Kejadian

Definisi

Ruang nama:

Windows.ApplicationModel.Search

Terjadi saat teks kueri pengguna berubah dan aplikasi perlu memberikan saran baru untuk ditampilkan di panel pencarian.

/// [add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
/// [remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
// Register
event_token SuggestionsRequested(TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void SuggestionsRequested(event_token const* cookie) const;

// Revoke with event_revoker
SearchPane::SuggestionsRequested_revoker SuggestionsRequested(auto_revoke_t, TypedEventHandler<SearchPane, SearchPaneSuggestionsRequestedEventArgs const&> const& handler) const;

[add: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
[remove: Windows.Foundation.Metadata.Deprecated("ISearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public event TypedEventHandler<SearchPane,SearchPaneSuggestionsRequestedEventArgs> SuggestionsRequested;

function onSuggestionsRequested(eventArgs) { /* Your code */ }
searchPane.addEventListener("suggestionsrequested", onSuggestionsRequested);
searchPane.removeEventListener("suggestionsrequested", onSuggestionsRequested);
- or -
searchPane.onsuggestionsrequested = onSuggestionsRequested;

Public Custom Event SuggestionsRequested As TypedEventHandler(Of SearchPane, SearchPaneSuggestionsRequestedEventArgs) 

Jenis Acara

TypedEventHandler<SearchPane,SearchPaneSuggestionsRequestedEventArgs>

Atribut

DeprecatedAttribute

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.

Catatan

Aplikasi tidak dapat menggunakan kotak pencarian (Windows.UI.Xaml.Controls.SearchBox/WinJS.UI.SearchBox) dan SearchPane. Menggunakan kotak pencarian dan panel pencarian di aplikasi yang sama menyebabkan aplikasi melemparkan pengecualian dengan pesan ini: "Tidak dapat membuat instans jenis 'Windows.UI.Xaml.Controls.SearchBox.'"

Saran dapat berasal dari tiga sumber: riwayat pencarian, file lokal, atau dari sumber yang ditentukan oleh aplikasi. Saran dikelompokkan menurut sumbernya dan ditampilkan dalam urutan berikut di panel pencarian: riwayat pencarian, file lokal, lalu sumber yang ditentukan aplikasi.

Jika aplikasi Anda berpartisipasi dalam kontrak Pencarian dan Anda ingin aplikasi menampilkan saran dari sumber yang Anda tentukan, Anda harus mendaftarkan handler untuk merespons saat peristiwa ini diaktifkan. Di penanganan aktivitas SuggestionsRequested Anda, tanggapi dengan mendapatkan saran dan mengisi SearchSuggestionCollection berdasarkan SearchPaneSuggestionsRequestedEventArgs pengguna. TeksKueri.

Catatan

Jika Anda ingin menanggapi peristiwa ini secara asinkron, Anda harus menggunakan SearchPaneSuggestionsRequestedEventArgs. Permintaan. GetDeferral.

Saran tidak dapat diberikan untuk kotak pencarian kosong, sehingga peristiwa ini tidak diaktifkan saat pengguna memperbarui kotak pencarian agar kosong.

Jenis saran pencarian

Ada dua jenis saran yang dapat ditampilkan aplikasi Anda: saran yang membantu pengguna memperbaiki kueri (saran kueri), dan saran yang merupakan hasil kueri aktual (saran hasil). Anda dapat memilih untuk menampilkan salah satu atau kedua jenis saran.

Jika Anda memberikan saran kueri dan pengguna memilihnya, aplikasi Anda harus merespons dengan menampilkan hasil untuk kueri yang dipilih dan disempurnakan di halaman hasil pencarian aplikasi Anda.

Jika Anda memberikan saran hasil, Anda juga harus mendaftarkan penanganan aktivitas ResultSuggestionChosen sehingga Anda dapat merespons saat pengguna memilih salah satu saran hasil Anda dan Anda dapat menampilkan hasilnya kepada pengguna.

Mendapatkan saran

Berikut adalah beberapa contoh sumber yang dapat digunakan aplikasi Anda untuk mendapatkan saran:

• Dari daftar lokal yang ditentukan aplikasi, statis,
• Dari URL yang mendukung saran dalam format OpenSearch

Menampilkan saran yang disediakan aplikasi di panel pencarian

Setelah Anda mendapatkan saran, Anda menampilkannya di panel pencarian dengan menambahkannya ke Permintaan. SearchSuggestionCollection.

Paling banyak, panel pencarian dapat menampilkan 5 saran. Jika Anda memilih untuk menampilkan saran kueri dan saran hasil, Anda harus mengelompokkan saran menurut jenis saran (kueri atau hasil) dan memisahkan grup menggunakan AppendSearchSeparator. Setiap pemisah menggantikan saran dan harus diikuti oleh setidaknya satu saran, mengurangi jumlah saran yang dapat Anda tampilkan.

Lihat juga

• SearchPane
• ResultSuggestionChosen
• SearchSuggestionCollection
• SearchPaneSuggestionsRequestedEventArgs
• SearchSuggestionCollection
• Sampel kontrak pencarian (Windows 8)