InkPresenter.ActivateCustomDrying Metode

Referensi

Definisi

Ruang nama:: Windows.UI.Input.Inking

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.

Edit

Menunjukkan bahwa aplikasi Anda memerlukan kontrol penuh atas penyajian input tinta.

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 penyajian (di atas konten aplikasi dan mengganti tinta basah).

Model hosting InkPresenter

InkCanvas

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.

InkDesktopHost (Windows 10 versi 1511 dan yang lebih baru)

Aplikasi Win32 dapat menghosting InkPresenter di InkDesktopHost menggunakan pohon visual DirectComposition.

Ini memerlukan objek IInkD2DRenderer untuk mengelola input tinta (lihat sampel tinta Kompleks).

CoreInkPresenterHost (Windows 10 Fall Creators Update dan yang lebih baru)

Host InkPresenter di Windows Anda sendiri .UI.Pohon komposisi tanpa kontrol InkCanvas terkait.

public:
 virtual InkSynchronizer ^ ActivateCustomDrying() = ActivateCustomDrying;

InkSynchronizer ActivateCustomDrying();

public InkSynchronizer ActivateCustomDrying();

function activateCustomDrying()

Public Function ActivateCustomDrying () As InkSynchronizer

Mengembalikan

InkSynchronizer

Objek yang digunakan untuk penyajian goresan tinta kustom.

Keterangan

Kode kesalahan

E_ILLEGAL_METHOD_CALL (0x8000000E)

Dilemparkan jika ActivateCustomDrying dipanggil setelah InkCanvas dimuat.

Metode ini harus dipanggil sebelum memuat InkCanvas.

Pengeringan kustom dan InkToolbar
Secara default, input tinta diproses pada utas latar belakang latensi rendah dan dirender "basah" saat digambar. Ketika stroke 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). Platform tinta memungkinkan Anda untuk mengambil alih perilaku ini dan sepenuhnya menyesuaikan pengalaman penintaan dengan mengeringkan input tinta secara kustom.

Jika aplikasi Anda mengambil alih perilaku penyajian tinta default InkPresenter dengan implementasi pengeringan kustom, goresan tinta yang dirender tidak lagi tersedia untuk InkToolbar dan perintah penghapusan bawaan InkToolbar tidak berfungsi seperti yang diharapkan. Untuk menyediakan fungsionalitas penghapusan, Anda harus menangani semua peristiwa penunjuk, melakukan pengujian hit pada setiap goresan, dan mengganti perintah "Hapus semua tinta" bawaan.

Untuk informasi selengkapnya tentang pengeringan kustom, lihat Interaksi pena dan Windows Ink di aplikasi UWP.

Berlaku untuk

Bagikan melalui