Bagikan melalui

Metode IInkCollector::get_CollectionMode (msinkaut.h)

  • Artikel

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

Properti ini bersifat baca/tulis.

Sintaks

HRESULT get_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 menginstal Kit Pengembangan Perangkat Lunak (SDK) Pc Edition Tablet (SDK) Microsoft Windows XP, tetapi tidak memiliki pengenal 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; gerakan tidak.
  • Minat peristiwa Gesture diatur ke FALSE (semua minat peristiwa lainnya tetap seperti sebelumnya).

Mode GestureOnly

  • Hanya gerakan yang dikumpulkan; tinta tidak. Goresan dihapus setelah dikirim ke pengenal gerakan.
  • Minat peristiwa Gesture diatur ke TRUE (semua minat peristiwa lainnya tetap seperti sebelumnya).
  • 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 single-stroke yang dikenali.
  • Minat peristiwa Gesture diatur ke TRUE (semua minat peristiwa lainnya tetap seperti sebelumnya).
  • 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 gerakan itu bukan alternatif teratas. Untuk mencegah tinta menghilang dan membatalkan pengumpulan gerakan, atur parameter Batalkan ke TRUE jika peristiwa 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 berada dalam mode InkAndGesture , Anda dapat:

  1. Atur properti CollectionMode ke InkAndGesture.
  2. Dalam peristiwa Stroke , hapus stroke.
  3. Dalam peristiwa Gesture , proses gerakan.
  4. 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

Lihat juga

Mengumpulkan PropertiInk

Properti Diaktifkan

IInkCollector

Enumerasi InkCollectionMode

Kelas InkCollector