Bagikan melalui

Metode IInkCollector::p ut_CollectionMode (msinkaut.h)

  • Artikel

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

Menampilkan nilai

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) Edisi PC Tablet (SDK) Microsoft Windows XP Tablet 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; 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:

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

Persyaratan

   
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