Bagikan melalui

SearchPane Kelas

  • Referensi

Definisi

Ruang nama:
Windows.ApplicationModel.Search
Edit

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 SearchPane
Public NotInheritable Class SearchPane
Warisan
Object Platform::Object IInspectable SearchPane
Atribut
ContractVersionAttribute DeprecatedAttribute MarshalingBehaviorAttribute

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.

Berlaku untuk

Lihat juga