SearchPane 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.
Dihentikan. Gunakan kontrol Windows.UI.Xaml.Controls.AutoSuggestBox sebagai gantinya. Mewakili dan mengelola panel pencarian yang terbuka saat pengguna mengaktifkan tombol Cari.
public ref class SearchPane sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.ApplicationModel.Search.SearchContract)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class SearchPane final/// [Windows.Foundation.Metadata.ContractVersion(Windows.ApplicationModel.Search.SearchContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
class SearchPane final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.ApplicationModel.Search.SearchContract))]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class SearchPane[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.ApplicationModel.Search.SearchContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Deprecated("SearchPane may be altered or unavailable for releases after Windows 10.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.ApplicationModel.Search.SearchContract")]
public sealed class SearchPanePublic NotInheritable Class SearchPane- Warisan
- Atribut
Persyaratan Windows
| Rangkaian perangkat |
Windows Desktop Extension SDK (diperkenalkan dalam 10.0.10240.0)
Xbox One Extensions for the UWP (diperkenalkan dalam 10.0.10586.0) |
| API contract |
Windows.ApplicationModel.Search.SearchContract (diperkenalkan dalam v1.0)
|
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 melempar pengecualian dengan pesan ini: "Tidak dapat membuat instans jenis 'Windows.UI.Xaml.Controls.SearchBox.'"
Objek ini tersedia untuk aplikasi yang berpartisipasi dalam kontrak Pencarian. Untuk memberi pengguna hasil pencarian, Anda harus menambahkan kode ke penanganan aktivitas Aktif yang merespons saat aplikasi diaktifkan untuk pencarian. Untuk mempelajari selengkapnya tentang merespons peristiwa aktivasi Pencarian , lihat webUISearchActivatedEventArgs (JavaScript) atau SearchActivatedEventArgs (C#/C++/VB).
Anda dapat melihat contoh kode yang menunjukkan cara merespons peristiwa pencarian dan mengelola panel pencarian di sampel Kontrak pencarian (Windows 8).
Properti
| Language |
Tag bahasa Internet Engineering Task Force (IETF) (standar BCP 47) yang mengidentifikasi bahasa yang saat ini terkait dengan perangkat input teks pengguna. |
| PlaceholderText |
Teks tempat penampung di kotak pencarian saat pengguna belum memasukkan karakter apa pun. |
| QueryText |
Teks saat ini di kotak pencarian panel pencarian. |
| SearchHistoryContext |
String yang mengidentifikasi konteks pencarian dan digunakan untuk menyimpan riwayat pencarian pengguna dengan aplikasi. |
| SearchHistoryEnabled |
Menunjukkan apakah pencarian pengguna sebelumnya dengan aplikasi secara otomatis dilacak dan digunakan untuk memberikan saran. |
| ShowOnKeyboardInput |
Mendapatkan atau mengatur apakah pengguna dapat membuka panel pencarian dengan mengetik. |
| Visible |
Menunjukkan apakah panel pencarian terbuka. |
Metode
| GetForCurrentView() |
Mengambil instans panel pencarian tempat pengguna dapat mencari di dalam aplikasi. |
| HideThisApplication() |
Menyembunyikan UI aplikasi saat ini. |
| SetLocalContentSuggestionSettings(LocalContentSuggestionSettings) |
Menentukan apakah saran berdasarkan file lokal secara otomatis ditampilkan di panel pencarian, dan menentukan kriteria yang digunakan Windows untuk menemukan dan memfilter saran ini. |
| Show() |
Memperlihatkan panel pencarian. |
| Show(String) |
Memperlihatkan panel pencarian dengan string kueri awal yang ditentukan. |
| TrySetQueryText(String) |
Mencoba mengatur teks di kotak pencarian panel pencarian. |
Acara
| QueryChanged |
Diaktifkan saat pengguna mengubah teks di kotak pencarian. |
| QuerySubmitted |
Diaktifkan saat pengguna mengirimkan teks di kotak pencarian dan aplikasi perlu menampilkan hasil pencarian. |
| ResultSuggestionChosen |
Diaktifkan saat pengguna memilih salah satu hasil yang disarankan yang disediakan oleh aplikasi dan ditampilkan di panel pencarian. |
| SuggestionsRequested |
Terjadi saat teks kueri pengguna berubah dan aplikasi perlu memberikan saran baru untuk ditampilkan di panel pencarian. |
| VisibilityChanged |
Diaktifkan saat pengguna membuka atau menutup panel pencarian. |