CoreInputView Kelas

Definisi

Ruang nama:

Windows.UI.ViewManagement.Core

Memungkinkan aplikasi mengontrol tampilan panel input yang ditambakan, dilepas, dipindahkan, atau transitory (dan UI terkait), menerima pemberitahuan saat panel dipindahkan, ditampilkan, atau disembunyikan, dan untuk menentukan bagian mana dari jendela aplikasi yang dikaburkan oleh panel.

Catatan

Tidak didukung di HoloLens.

public ref class CoreInputView sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 327680)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CoreInputView final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CoreInputView

Public NotInheritable Class CoreInputView

Warisan

Object Platform::Object IInspectable CoreInputView

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 Fall Creators Update (diperkenalkan dalam 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v5.0)

Keterangan

Tampilan utama mengacu pada salah satu tampilan CoreInputViewKind.Keyboard atau CoreInputViewKind.Handwriting , sementara CoreInputView dapat menjadi salah satu nilai dari CoreInputViewKind.Handwriting.

Digunakan oleh kerangka kerja (seperti XAML) atau kontrol teks kustom saja.

Aplikasi Anda dapat menggunakan info yang diekspos oleh objek ini untuk menyesuaikan dan me-reflow UI-nya untuk memperhitungkan oklusi apa pun.

API CoreInputView mendukung jenis panel input berikut.

• Panel Input Lunak (SIP) Yang Ditambatkan seperti keyboard Sentuh dan panel tulisan tangan – biasanya, UI aplikasi Anda akan di-reflow.
• Toolbar mengambang atau SIP – biasanya, UI aplikasi Anda tidak mengalir kembali.
• Panel overlay seperti inline Ink atau IME candidate windows – biasanya, UI aplikasi Anda tidak melakukan reflow untuk kontrol edit, tetapi melakukan reflow untuk saran teks/pencarian.

Panel input muncul saat pengguna melakukan tindakan yang mengharuskan mereka untuk memberikan informasi, seperti memasukkan bidang teks.

Secara default, Windows menangani peristiwa panel input dan memposisikan ulang konten sehingga pengguna dapat melihat kontrol dengan fokus. Jika Anda mengatur CoreTextEditContext.InputPaneDisplayPolicy ke Manual di aplikasi, Anda bertanggung jawab untuk menampilkan dan menyembunyikan panel input menggunakan TryShowPrimaryView dan TryHidePrimaryView. Gunakan kelas ini untuk mengambil alih perilaku default dan menyesuaikan panel input.

Panggil GetForCurrentView untuk mendapatkan objek CoreInputView.

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

Catatan

Kelas ini tidak lincah, 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
1803	17134	TryTransferXYFocusToPrimaryView
1803	17134	XYFocusTransferredToPrimaryView
1803	17134	XYFocusTransferringFromPrimaryView
1809	17763	TryHide
1809	17763	CobaTampakkan
1809	17763	TryShow(CoreInputViewKind)
1903	18362	GetForUIContext
2004	19041	PrimaryViewHiding
2004	19041	PrimaryViewShowing

Metode

GetCoreInputViewOcclusions()	Mengambil referensi ke setiap panel input yang saat ini menempati aplikasi.
GetForCurrentView()	Mengambil objek CoreInputView yang terkait dengan jendela saat ini.
GetForUIContext(UIContext)	Mendapatkan objek CoreInputView yang terkait dengan tampilan yang memiliki pengidentifikasi konteks yang ditentukan.
IsKindSupported(CoreInputViewKind)	Mendapatkan apakah jenis CoreInputView yang ditentukan didukung.
TryHide()	Mencoba menyembunyikan (jika terlihat) panel input yang terkait dengan panel CoreInputView .
TryHidePrimaryView()	Mencoba menyembunyikan (jika terlihat) panel input yang terkait dengan CoreInputView.
TryShow()	Upaya untuk menampilkan (jika disembunyikan) panel input yang terkait dengan CoreInputView.
TryShow(CoreInputViewKind)	Upaya untuk menampilkan (jika disembunyikan) jenis panel input yang ditentukan yang terkait dengan CoreInputView.
TryShowPrimaryView()	Mencoba menampilkan (jika disembunyikan) panel CoreInputView . Metode ini adalah "upaya terbaik" dan hanya menjamin bahwa pengguna memiliki cara untuk berinteraksi dengan kontrol yang berfokus. Untuk Panel Input Lunak (SIP) yang ditambatkan seperti keyboard Sentuh dan panel tulisan tangan, panel ditampilkan hanya jika keyboard perangkat keras tidak tersedia.
TryTransferXYFocusToPrimaryView(Rect, CoreInputViewXYFocusTransferDirection)	Mencoba memindahkan fokus dari UI aplikasi ke panel input.

Acara

OcclusionsChanged	Terjadi ketika satu atau beberapa objek CoreInputViewOcclusion mengubah posisi atau area penghubungnya sebagai respons terhadap reposisi panel input yang terkait dengan CoreInputView.
PrimaryViewAnimationStarting	Animasi dalam aplikasi yang terjadi sebagai respons terhadap peragaan atau persembunyian tampilan utama CoreInputView .
PrimaryViewHiding	Terjadi sebelum panel input yang terkait dengan CoreInputView disembunyikan (jika terlihat).
PrimaryViewShowing	Terjadi sebelum panel input yang terkait dengan CoreInputView ditampilkan (jika disembunyikan).
SupportedKindsChanged	Terjadi ketika kumpulan tampilan CoreInputViewKind yang didukung untuk CoreInputView berubah.
XYFocusTransferredToPrimaryView	Terjadi ketika fokus dipindahkan ke panel input dari UI aplikasi.
XYFocusTransferringFromPrimaryView	Terjadi sebelum panel input kehilangan fokus dan sebelum elemen UI mendapatkan fokus.

Lihat juga

• CoreFrameworkInputView