Bagikan melalui


Windows.UI.Input.Inking Ruang nama

Menyediakan dukungan input, pemrosesan, dan manajemen untuk aplikasi Windows Ink. Drive ini termasuk:

  • Menggambar goresan tinta.
  • Menangkap goresan.
  • Merender goresan.
  • Memilih goresan.
  • Menghapus stroke.
  • Menyimpan dan memuat stroke.
  • Mengonversi goresan menjadi teks melalui pengenalan tulisan tangan.
  • Menyalin dan menempelkan goresan dari clipboard.
  • Tekan pengujian (atau penargetan stroke).

Kelas

InkDrawingAttributes

Menyediakan properti yang terkait dengan gambar InkStroke.

InkDrawingAttributesPencilProperties

Menyediakan satu set properti InkDrawingAttributes statis untuk merender goresan pensil pada InkCanvas.

Dapatkan instans kelas ini dengan memanggil InkDrawingAttributes.CreateForPencil dan mengakses InkDrawingAttributes.PencilProperties.

InkInputConfiguration

Mengelola jenis input sekunder mana yang dapat diproses oleh objek InkPresenter .

InkInputProcessingConfiguration

Mengelola bagaimana input diproses oleh objek InkPresenter .

InkManager

Catatan

Untuk aplikasi Universal Windows menggunakan Extensible Application Markup Language (XAML), sebaiknya gunakan InkPresenter dan kontrol InkCanvas alih-alih InkManager.

Mengelola input, manipulasi, dan pemrosesan (termasuk pengenalan tulisan tangan) dari satu atau beberapa objek InkStroke .

InkModelerAttributes

Mengelola jenis atribut pemodel tinta mana yang dapat diproses oleh objek InkPresenter .

InkPoint

Menyediakan data input mentah untuk satu titik yang digunakan dalam pembangunan InkStroke.

InkPresenter

Menyediakan properti, metode, dan peristiwa untuk mengelola input, pemrosesan, dan penyajian input tinta (standar dan dimodifikasi) untuk kontrol InkCanvas .

InkPresenterProtractor

Mewakili stensil visual, dalam bentuk protraktor untuk menggambar busur dan kurva, ditampilkan sebagai overlay semi transparan pada InkCanvas.

Stensil mengubah bagaimana goresan tinta dirender:

  • Ini mematahkan goresan tinta ke tepi stensil jika ujung pena berada dalam ambang jarak (selokan).
  • Ini bertindak sebagai masker dan mencegah gambar goresan tinta di dalam area yang dikaburkan oleh stensil.

InkPresenterRuler dapat dimanipulasi baik secara terprogram maupun oleh pengguna. Ini juga menskalakan dan menerjemahkan dengan InkCanvas.

InkPresenterRuler

Mewakili stensil visual, dalam bentuk aturan lurus untuk menggambar garis lurus, ditampilkan sebagai overlay semi transparan pada InkCanvas.

Stensil mengubah bagaimana goresan tinta dirender:

  • Ini mematahkan goresan tinta ke tepi stensil jika ujung pena berada dalam ambang jarak (selokan).
  • Ini bertindak sebagai masker dan mencegah gambar goresan tinta di dalam area yang dikaburkan oleh stensil.

InkPresenterRuler dapat dimanipulasi baik secara terprogram maupun oleh pengguna. Ini juga menskalakan dan menerjemahkan dengan InkCanvas.

InkRecognitionResult

Menyediakan properti dan metode untuk mengelola data pengenalan tulisan tangan InkStroke .

Hasil pengenalan dihasilkan untuk setiap kata yang terdeteksi oleh InkRecognizer.

InkRecognizer

Mengelola semua aspek pengenalan tulisan tangan.

InkRecognizerContainer

Menyediakan properti dan metode untuk mengelola satu atau beberapa objek InkRecognizer yang digunakan untuk pengenalan tulisan tangan.

InkRecognizerContainer null jika mesin pengenalan tidak tersedia pada sistem.

InkStroke

Satu goresan tinta, termasuk parameter kurva Bézier yang digunakan untuk penyajian akhir stroke.

InkStrokeBuilder

Membangun goresan dari input pointer mentah.

Catatan

Untuk aplikasi Universal Windows menggunakan Extensible Application Markup Language (XAML), sebaiknya gunakan InkPresenter dan kontrol InkCanvas alih-alih InkManager.

Gunakan CreateStrokeFromInkPoints dan SetDefaultDrawingAttributes untuk menyusun stroke secara terprogram untuk InkPresenter.

InkStrokeContainer

Menyediakan properti dan metode untuk menyimpan dan mengelola koleksi objek InkStroke yang dirender oleh InkPresenter.

Modifikasi yang dilakukan pada salah satu goresan tinta dalam wadah stroke segera dirender ke permukaan gambar yang terkait dengan InkPresenter.

InkStrokeInput

Menyediakan properti dan peristiwa untuk StrokeInput yang terkait dengan objek InkPresenter .

InkStrokeRenderingSegment

Satu segmen stroke tinta lengkap.

Satu segmen terdiri dari titik awal, titik akhir, dan dua titik kontrol Bezier. Namun, untuk serangkaian segmen yang membentuk stroke, titik terakhir dari segmen sebelumnya adalah titik pertama dari segmen saat ini. Ini berarti bahwa hanya titik akhir untuk setiap segmen yang diperlukan untuk mewakili stroke lengkap.

Setiap goresan adalah vektor objek InkStrokeRenderingSegment dengan segmen pertama yang diidentifikasi oleh satu titik awal dan semua segmen yang tersisa diidentifikasi oleh titik akhir dan dua titik kontrol Bezier.

InkStrokesCollectedEventArgs

Berisi data peristiwa untuk peristiwa StrokesCollected dari InkPresenter yang terkait dengan kontrol InkCanvas .

Secara default, goresan tinta diproses pada utas latar belakang latensi rendah dan dirender basah saat digambar. Ketika goresan selesai (pena atau jari diangkat, atau tombol mouse dilepaskan), goresan diproses pada utas UI dan dirender kering ke lapisan InkCanvas (di atas konten aplikasi). Jika utas UI sibuk, lebih dari satu goresan tinta mungkin diproses (dikumpulkan) saat utas tersedia.

Perilaku ini dapat ditimpa dengan memanggil metode ActivateCustomDrying sebelum memuat InkCanvas.

InkStrokesErasedEventArgs

Berisi data peristiwa untuk peristiwa StrokesErased dari InkPresenter yang terkait dengan kontrol InkCanvas .

Secara default, data goresan tinta dan penyajian dikelola sepenuhnya oleh kontrol InkCanvas . Namun, perilaku ini dapat ditimpa dengan memanggil metode ActivateCustomDrying sebelum memuat InkCanvas.

InkSynchronizer

Mengelola sinkronisasi input tinta dan menyediakan metode untuk merendernya ke konteks perangkat Direct2D aplikasi Universal Windows Anda, alih-alih kontrol InkCanvas default. Ini memerlukan objek IInkD2DRenderer untuk mengelola input tinta (lihat sampel tinta Kompleks).

Secara default, input tinta diproses pada utas latar belakang latensi rendah dan dirender "basah" saat digambar. Ketika goresan selesai (pena atau jari diangkat, atau tombol mouse dilepaskan), goresan diproses pada utas UI dan dirender "kering" ke lapisan InkCanvas (di atas konten aplikasi dan mengganti tinta basah).

Dengan memanggil ActivateCustomDrying (sebelum InkCanvas dimuat ), aplikasi membuat objek InkSynchronizer untuk menyesuaikan bagaimana goresan tinta dirender kering ke SurfaceImageSource atau VirtualSurfaceImageSource. Misalnya, goresan tinta dapat diraster dan diintegrasikan ke dalam konten aplikasi alih-alih sebagai lapisan InkCanvas terpisah.

InkUnprocessedInput

Menyediakan properti dan peristiwa untuk pemrosesan kustom data tinta dari kontrol InkCanvas . Data tidak diproses oleh InkPresenter.

Gunakan InkInputProcessingConfiguration untuk mengidentifikasi data yang akan diteruskan sebagai UnprocessedInput.

PenAndInkSettings

Menyediakan akses ke pengaturan pengguna yang terkait dengan menerima dan mengonversi tinta ke input teks dalam kontrol teks (saat HandwritingView diaktifkan).

Antarmuka

IInkPointFactory

Menentukan implementasi untuk jenis yang menghasilkan objek InkPoint yang digunakan dalam konstruksi InkStroke.

IInkPresenterRulerFactory

Mendefinisikan implementasi untuk jenis yang menghasilkan objek InkPresenterRuler yang digunakan dalam konstruksi InkPresenter.

IInkPresenterStencil

Mewakili stensil visual, ditampilkan sebagai overlay semi transparan pada InkCanvas.

Stensil mengubah bagaimana goresan tinta dirender:

  • Ini mematahkan goresan tinta ke tepi stensil jika ujung pena berada dalam ambang jarak (selokan).
  • Ini bertindak sebagai masker dan mencegah gambar goresan tinta di dalam area yang dikaburkan oleh stensil.

Stensil dapat dimanipulasi baik secara terprogram maupun oleh pengguna. Ini juga menskalakan dan menerjemahkan dengan InkCanvas.

IInkRecognizerContainer

Mewakili satu atau beberapa objek InkRecognizer .

IInkStrokeContainer

Mewakili manajer untuk koleksi objek InkStroke yang dirender oleh InkPresenter.

Modifikasi yang dilakukan pada salah satu goresan tinta dalam wadah stroke segera dirender ke permukaan gambar yang terkait dengan InkPresenter.

Enum

HandwritingLineHeight

Menentukan ruang tulisan tangan yang tersedia saat menggunakan tinta untuk input teks dalam kontrol teks (saat HandwritingView diaktifkan).

InkDrawingAttributesKind

Menentukan jenis InkDrawingAttributes yang terkait dengan InkStroke.

InkHighContrastAdjustment

Menentukan bagaimana objek InkPresenter menangani input (standar dan dimodifikasi) dari kontrol InkCanvas terkait saat sistem berada dalam mode kontras tinggi.

InkInputProcessingMode

Menentukan bagaimana objek InkPresenter menginterpretasikan input dari kontrol InkCanvas terkait.

Secara default, input ditangani sebagai tinta standar atau menghapus goresan, atau dapat diteruskan sebagai UnprocessedInput ke aplikasi Anda untuk pemrosesan kustom.

InkInputRightDragAction

Menentukan bagaimana objek InkPresenter menangani input sekunder dari tombol barel pena, ujung penghapus pena, tombol mouse kanan, atau sejenisnya.

Secara default, input sekunder ini diproses sebagai input utama dan dirender sebagai InkStroke (lihat keterangan).

InkManipulationMode

Menentukan mode input tinta.

InkPersistenceFormat

Menentukan format untuk menyimpan input tinta.

InkPresenterPredefinedConfiguration

Menentukan perilaku penintaan dari satu atau beberapa titik kontak. Digunakan dengan SetPredefinedConfiguration.

InkPresenterStencilKind

Menentukan jenis stensil yang dapat ditampilkan pada InkCanvas.

InkRecognitionTarget

Menunjukkan goresan mana yang ingin Anda sertakan dalam pengenalan tulisan tangan.

PenHandedness

Mengidentifikasi tangan penulisan pilihan, seperti yang ditentukan oleh pengguna di Pengaturan -> Perangkat -> Pena & Windows Ink -> Pilih tangan mana yang Anda tulis.

PenTipShape

Mengidentifikasi bentuk PenTip.

Lihat juga