Metode IInkOverlay::p ut_CollectionMode (msinkaut.h)

Artikel
03/13/2024

Mendapatkan atau mengatur mode koleksi yang menentukan apakah tinta, gerakan, atau keduanya dikenali sebagai pengguna menulis.

Properti ini bersifat baca/tulis.

Sintaks

HRESULT put_CollectionMode(
  InkCollectionMode Mode
);

Parameter

Mode

Nilai kembali

Tidak ada

Keterangan

Untuk daftar mode yang dapat Anda gunakan, lihat jenis enumerasi InkCollectionMode . Namun, saat menggunakan properti CollectionMode pada sistem yang memiliki Microsoft Windows? Kit Pengembangan Perangkat Lunak (SDK) XP Tablet PC Edition diinstal tetapi tidak memiliki recognizer yang terinstal, mode tidak dapat diatur ke GestureOnly atau InkAndGesture.

Catatan Objek InkCollector , objek InkOverlay , atau kontrol InkPicture menghasilkan kesalahan jika Anda mencoba mengubah properti CollectionMode saat tinta sedang dikumpulkan. Untuk menghindari konflik ini, periksa properti CollectingInk sebelum mengubah properti CollectionMode .

Perilaku berikut terjadi untuk setiap nilai CollectionMode :

Mode InkOnly

Hanya tinta yang dikumpulkan; isyarat tidak.
Minat peristiwa Gerakan diatur ke FALSE (semua minat peristiwa lainnya tetap seperti semata).

Mode GestureOnly

Hanya gerakan yang dikumpulkan; Tinta tidak. Goresan dihapus setelah dikirim ke pengenal gerakan.
Minat peristiwa Gerakan diatur ke TRUE (semua minat peristiwa lainnya tetap seperti semata).
Kolektor tinta tidak menembakkan peristiwa terkait stroke dan paket berikut: peristiwa CursorDown, Stroke, NewPackets, dan NewInAirPackets .
Peristiwa kursor diaktifkan.
Tinta selalu dihapus.

Mode InkAndGesture

Tinta dan gerakan dikumpulkan.
Hanya gerakan goresan tunggal yang dikenali.
Minat peristiwa Gerakan diatur ke TRUE (semua minat peristiwa lainnya tetap seperti semata).
Peristiwa Gerakan diaktifkan terlebih dahulu, memungkinkan Anda menerima atau membatalkan gerakan. Untuk membatalkan gerakan, atur parameter Batalkan ke TRUE. Membatalkan gerakan memaksa pengumpul tinta untuk mengumpulkan tinta.

Mengubah mode pengumpulan tidak mengubah status gerakan individual.

Perilaku yang tidak diinginkan mungkin terjadi ketika CollectionMode diatur ke InkAndGesture dan minat objek/kontrol dalam gerakan yang diketahui diatur (dengan memanggil metode SetGestureStatus ). Jika Anda menggambar tinta yang terlihat seperti gerakan yang diketahui dan gerakan yang diketahui ada dalam daftar alternatif pengenal, peristiwa Gerakan menembak dan tinta menghilang, bahkan jika gerakannya bukan alternatif teratas. Untuk mencegah tinta menghilang dan membatalkan pengumpulan gerakan, atur parameter Batalkan ke TRUE jika peristiwa tersebut adalah yang tidak Anda minati.

Saat CollectionMode diatur ke GestureOnly, batas waktu antara saat pengguna menambahkan gerakan dan kapan peristiwa Gesture terjadi adalah nilai tetap yang tidak dapat diubah secara terprogram. Pengenalan gerakan lebih cepat dalam mode InkAndGesture . Untuk mencegah pengumpulan tinta saat dalam mode InkAndGesture , Anda dapat:

Atur properti CollectionMode ke InkAndGesture.
Dalam peristiwa Stroke , hapus stroke.
Dalam peristiwa Gerakan , proses gerakan.
Atur DynamicRendering ke FALSE untuk mencegah aliran tinta saat gesturing.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	msinkaut.h
Pustaka	InkObj.dll