Enumerasi InkCollectionMode (msinkaut.h)

Menentukan nilai yang menentukan apakah tinta, gerakan, atau tinta dan gerakan dikenali saat pengguna menulis.

Sintaks

typedef enum InkCollectionMode {
  ICM_InkOnly = 0,
  ICM_GestureOnly,
  ICM_InkAndGesture
} ;

Konstanta

ICM_InkOnly Nilai: 0 Hanya mengumpulkan tinta, menciptakan stroke. Minat peristiwa Gerakan diatur ke FALSE, yang berarti bahwa gerakan tidak dikumpulkan (semua minat peristiwa lainnya tetap seperti semata).
ICM_GestureOnly Hanya mengumpulkan gerakan dan tidak menciptakan goresan. Gerakan dapat berupa single atau multi-stroke. Gerakan multi-stroke diterima jika goresan dibuat dalam waktu yang ditetapkan oleh timer bawaan pengenal. Semua peristiwa terkait stroke dan terkait paket tidak diaktifkan dari InkCollector. Peristiwa kursor menembak, dan tinta selalu dihapus. Minat peristiwa Gerakan diatur ke TRUE, yang berarti bahwa gerakan dikumpulkan (semua minat peristiwa lainnya tetap seperti semata).
ICM_InkAndGesture Hanya menerima gerakan goresan tunggal. Peristiwa Gerakan diaktifkan terlebih dahulu, memberi pengguna kemampuan untuk mengatakan Batalkan = TRUE atau FALSE. Defaultnya adalah TRUE, kecuali ketika NoGesture adalah gerakan utama, Batalkan default ke FALSE. Jika TRUE, tinta adalah gerakan dan dihapus. Jika FALSE, gerakannya adalah tinta dan peristiwa Stroke diaktifkan. Minat peristiwa Gerakan diatur ke TRUE (semua minat peristiwa lainnya disimpan apa adanya).

Keterangan

Jika pengguna mencoba klik kanan dan memindahkan pena saat dalam mode InkOnly atau InkAndGesture, tinta mengalir dari ujung pena. Saat menangani peristiwa Stroke , Anda harus menghapus tinta yang mengalir sebagai akibat dari gerakan pena.

Ketika InkCollectionMode diatur ke GestureOnly (diatur melalui properti CollectionMode ), batas waktu antara saat pengguna menambahkan gerakan dan ketika 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 CollectionMode ke InkAndGesture.
• Dalam peristiwa Stroke , hapus stroke.
• Dalam peristiwa Gerakan , proses gerakan.
• Atur DynamicRendering ke FALSE.

Saat menggunakan enumerasi ini dengan kontrol InkPicture (atau objek InkCollector atau InkOverlay ) pada sistem yang menginstal Kit Pengembangan Perangkat Lunak (SDK) Edisi PC Tablet Microsoft Windows XP tetapi tidak memiliki pengenal, mode tidak dapat diatur ke GestureOnly atau InkAndGesture.

Pengumpul tinta selalu membuat goresan (mode InkOnly) atau gerakan (mode GestureOnly) dan kadang-kadang dibuat keduanya (mode InkAndGesture).

Skenario umum untuk setiap mode mengikuti.

• InkOnly:
  1. Peristiwa CursorInRange diaktifkan.
  2. Peristiwa NewInAirPackets diaktifkan.
  3. Peristiwa KursorDown diaktifkan.
  4. Peristiwa NewPackets diaktifkan.
  5. Objek IInkStrokeDisp dibuat.
  6. Peristiwa CursorOutOfRange diaktifkan.
  Catatan Anda mungkin tidak selalu ingin mengaktifkan peristiwa CursorOutOfRange . Jika Anda ingin terus menggambar tinta, Anda dapat kembali ke peristiwa NewInAirPackets atau CursorDown setelah stroke selesai.
   
• GestureOnly:
  1. Peristiwa CursorInRange diaktifkan.
  2. Peristiwa NewInAirPackets diaktifkan.
  3. Peristiwa KursorDown diaktifkan.
  4. Peristiwa NewPackets diaktifkan.
  5. Baik objek IInkGesture dibuat atau, jika gerakan kursor tidak mewakili gerakan, tidak ada yang terjadi.
  6. Peristiwa CursorOutOfRange diaktifkan.
  Catatan Gerakan tunggal atau multi-goresan diterima dalam mode ini.
   
• InkAndGesture:
  1. Peristiwa CursorInRange diaktifkan.
  2. Peristiwa NewInAirPackets diaktifkan.
  3. Peristiwa KursorDown diaktifkan.
  4. Peristiwa NewPackets diaktifkan.
  5. Objek IInkGesture atau objek IInkStrokeDisp dibuat.
  6. Peristiwa CursorOutOfRange diaktifkan.
  Catatan Hanya gerakan single-stroke yang diterima dalam mode ini.
   

Perilaku yang tidak diinginkan mungkin terjadi ketika properti CollectionMode diatur ke InkAndGesture dan minat objek atau kontrol dalam gerakan yang diketahui diatur (dengan memanggil metode SetGestureStatus ). Jika pengguna menggambar tinta yang menyerupan gerakan yang ada dalam daftar pengenalan alternatif, peristiwa Gerakan menembak dan tinta menghilang, bahkan jika gerakan bukan alternatif teratas. Untuk mencegah tinta menghilang dan membatalkan pengumpulan gerakan, atur Batalkan ke TRUE jika acara adalah salah satu tempat Anda tidak ingin pengenal merespons.

Persyaratan

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

Lihat juga

Properti CollectionMode [Kelas InkCollector]

Peristiwa Gerakan

Kelas InkCollector

Kelas InkOverlay

Referensi Kontrol Gambar Tinta

Peristiwa Goresan