CoreTextEditContext 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.
Objek utama yang digunakan oleh kontrol input teks untuk berkomunikasi dengan server input teks.
public ref class CoreTextEditContext sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreTextEditContext final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreTextEditContextPublic NotInheritable Class CoreTextEditContext- Warisan
- Atribut
Persyaratan Windows
| Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Keterangan
Untuk mendapatkan objek jenis ini, panggil CoreTextServicesManager.CreateEditContext.
Riwayat versi
| Versi Windows | Versi SDK | Nilai ditambahkan |
|---|---|---|
| 1511 | 10586 | NotifyFocusLeaveCompleted |
Properti
| InputPaneDisplayPolicy |
Mendapatkan atau mengatur nilai yang menunjukkan apakah panel input harus ditampilkan secara otomatis saat fokus memasukkan kontrol input teks Anda. Nilai defaultnya adalah Otomatis, menunjukkan bahwa panel input akan ditampilkan secara otomatis. Nilai Manual menunjukkan bahwa aplikasi Anda akan bertanggung jawab untuk menampilkan dan menyembunyikan panel input menggunakan InputPane.TryShow dan TryHide. |
| InputScope |
Mendapatkan atau mengatur nilai yang menunjukkan cakupan input kontrol input teks. |
| IsReadOnly |
Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol edit dapat diedit. |
| Name |
Mendapatkan atau mengatur nama deskriptif untuk kontrol input teks. Kerangka kerja aplikasi biasanya menggunakan properti seperti "nama" atau "id" untuk mengidentifikasi kontrol, jadi disarankan agar Anda mengatur properti ini sesuai pada server input teks sehingga prosesor input dapat mempertahankan konteks input dengan lebih baik, dan memberikan saran yang lebih baik. |
Metode
| NotifyFocusEnter() |
Memberi tahu server input teks yang fokus telah memasukkan kontrol input teks. |
| NotifyFocusLeave() |
Memberi tahu server input teks yang fokus telah meninggalkan kontrol input teks. |
| NotifyLayoutChanged() |
Memberi tahu server input teks bahwa tata letak teks di dalam kontrol input teks telah berubah. |
| NotifySelectionChanged(CoreTextRange) |
Memberi tahu server input teks tentang perubahan apa pun yang perlu dilakukan kontrol input teks ke rentang pilihan. Ini penting untuk menjaga status internal kontrol dan status internal server disinkronkan. |
| NotifyTextChanged(CoreTextRange, Int32, CoreTextRange) |
Memberi tahu server input teks tentang perubahan apa pun yang perlu dilakukan kontrol input teks ke teks. Ini penting untuk menjaga status internal kontrol dan status internal server disinkronkan. Karena perubahan pada teks juga cenderung memengaruhi rentang pilihan, metode mengambil rentang pilihan sebagai parameter. |
Acara
| CompositionCompleted |
Terjadi ketika komposisi telah selesai. |
| CompositionStarted |
Terjadi ketika komposisi telah dimulai. |
| FocusRemoved |
Terjadi ketika fokus dihapus secara paksa dari kontrol input teks. Aplikasi harus menangani peristiwa ini untuk menghapus fokus untuk kontrol input teks yang sesuai. |
| FormatUpdating |
Terjadi ketika server input teks perlu menerapkan format yang berbeda ke rentang teks tertentu. Ini biasanya terjadi selama komposisi. |
| LayoutRequested |
Terjadi ketika server input teks perlu mendapatkan kotak pembatas dari rentang teks dan kontrol input teks itu sendiri. Aplikasi harus menangani peristiwa ini dan mengembalikan informasi geometri yang diminta. |
| NotifyFocusLeaveCompleted |
Terjadi setelah fokus meninggalkan kontrol input teks. |
| SelectionRequested |
Terjadi ketika server input teks perlu mendapatkan rentang teks yang mewakili teks yang saat ini dipilih dalam kontrol input teks. Aplikasi harus menangani peristiwa ini dan mengembalikan rentang yang diminta. |
| SelectionUpdating |
Terjadi ketika server input teks perlu memodifikasi rentang teks yang saat ini dipilih dalam kontrol input teks. Kejadian ini bisa menjadi hasil dari prosesor input yang perlu memilih beberapa teks, atau untuk memindahkan tanda sisipan. Kontrol input teks harus mengatur rentang pilihannya. |
| TextRequested |
Terjadi ketika server input teks perlu mendapatkan rentang teks dari kontrol input teks. Aplikasi harus menangani peristiwa ini dan mengembalikan rentang yang diminta. |
| TextUpdating |
Terjadi ketika server input teks perlu memodifikasi teks di dalam kontrol input teks. Kejadian ini bisa menjadi hasil dari peristiwa utama— seperti menyisipkan satu karakter— atau hasil pemrosesan yang dilakukan oleh prosesor input, seperti koreksi dan prediksi otomatis. Saat menangani peristiwa, kontrol input teks harus mengganti rentang dengan teks baru yang disediakan oleh server, dan juga memindahkan tanda sisipan ke akhir teks baru. |