InputPane Kelas

  • Referensi

Definisi

Ruang nama:
Windows.UI.ViewManagement
Edit

Memungkinkan aplikasi menerima pemberitahuan saat papan ketik sentuh yang ditambatkan, atau Panel Input Lunak (SIP), akan ditampilkan atau disembunyikan, dan untuk menentukan bagian jendela aplikasi mana yang dikaburkan oleh panel input.

Catatan

API InputPane memberikan informasi oklusi yang akurat hanya untuk panel yang ditampung. Untuk Windows 10 Creators Fall Update dan yang lebih baru, sebaiknya gunakan API berikut untuk menangani oklusi dengan panel input dock, undocked, moveable, dan transitory seperti Soft Input Panels (SIP), jendela kandidat Input Method Editor (IME), toolbar mengambang, dan sebagainya.

public ref class InputPane sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class InputPane final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class InputPane
Public NotInheritable Class InputPane
Warisan
Object Platform::Object IInspectable InputPane
Atribut
ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

Panel input muncul saat pengguna melakukan tindakan yang mengharuskan mereka memasukkan informasi, seperti memilih bidang entri teks. Secara default, Windows menangani peristiwa panel input dan memposisikan ulang konten sehingga pengguna dapat melihat di mana mereka mengetik. Jika Anda mengatur CoreTextEditContext.InputPaneDisplayPolicy ke Manual di aplikasi Anda, Anda bertanggung jawab untuk menampilkan dan menyembunyikan panel input menggunakan TryShow dan TryHide. Gunakan kelas ini untuk mengambil alih perilaku default dan menyesuaikan panel input.

Dalam beberapa kasus, antarmuka pengguna overlay seperti InputPane tidak didukung sepenuhnya. Drive ini termasuk:

Panggil GetForCurrentView untuk mendapatkan objek InputPane.

Setelah Anda mendaftar untuk menerima pemberitahuan panel input, sistem memanggil delegasi peristiwa Anda setiap kali panel input ditampilkan atau disembunyikan untuk jendela yang terlihat saat Anda memanggil metode GetForCurrentView .

Catatan

Kelas ini tidak tangkas, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX).

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1903 18362 GetForUIContext

Properti

OccludedRect

Mendapatkan wilayah jendela aplikasi yang dikaburkan oleh panel input.
Visible

Mendapatkan atau menetapkan nilai yang menunjukkan apakah panel input ditampilkan.

Penting

Hanya berlaku untuk keluarga perangkat Xbox.

Untuk aplikasi universal, properti OccludedRect menunjukkan wilayah jendela aplikasi yang dihalangi oleh panel input.

Metode

GetForCurrentView()

Mendapatkan objek InputPane yang terkait dengan jendela aplikasi yang saat ini terlihat.
GetForUIContext(UIContext)

Mendapatkan objek InputPane yang terkait dengan tampilan dengan pengidentifikasi konteks yang ditentukan.
TryHide()

Mencoba menyembunyikan InputPane, jika terlihat.
TryShow()

Mencoba menampilkan InputPane, jika disembunyikan.

Metode ini adalah "upaya terbaik" dan hanya menjamin bahwa pengguna memiliki cara untuk memasukkan teks dalam kontrol yang difokuskan. Keyboard sentuh, atau Panel Input Lunak (SIP), ditampilkan hanya jika keyboard perangkat keras tidak tersedia.

Acara

Hiding

Terjadi saat panel input mulai meluncur di luar tampilan.
Showing

Terjadi saat panel input mulai meluncur ke dalam tampilan.

Berlaku untuk

Lihat juga