Konstanta PacketPropertyGuids

  • Artikel

Menentukan nilai yang menentukan properti paket. PCAPI Tablet menggunakan pengidentifikasi unik global (GUID) untuk mengidentifikasi properti paket, yang dalam COM adalah string konstan.

Di C++, Anda dapat mengakses konstanta ini di file header Msinkaut.h, yang terletak di <direktori systemdrive>:\Program Files\Microsoft SDKs\Windows\v6.0\Include jika Anda menginstal SDK di lokasi default. Dalam C++, konstanta ini adalah WCHAR, bukan BSTR. Konversikan menjadi BSTR sebelum digunakan. Untuk informasi selengkapnya tentang jenis data BSTR, lihat Menggunakan Pustaka COM.

Tabel berikut mencantumkan bidang pengidentifikasi unik global (GUID) properti paket yang tersedia. Gunakan GUID ini untuk menentukan properti mana yang dikandung paket saat Anda membuat konteks tablet. Untuk menentukan rentang dan resolusi properti, panggil metode GetPropertyMetrics . Konstanta dalam tabel di bawah ini dimulai dengan "STR_" adalah representasi string dari konstanta biner terkait yang diperlihatkan dalam sel tabel yang sama.

Terus-menerus Deskripsi
STR_GUID_X atau GUID_PACKETPROPERTY_GUID_X
 Koordinat x di ruang koordinat tablet. Setiap paket berisi properti ini secara default. Asal (0,0) tablet adalah sudut kiri atas.
STR_GUID_Y atau GUID_PACKETPROPERTY_GUID_Y
 Koordinat y di ruang koordinat tablet. Setiap paket berisi properti ini secara default. Asal (0,0) tablet adalah sudut kiri atas.
STR_GUID_Y atau GUID_PACKETPROPERTY_GUID_Y
 Koordinat y di ruang koordinat tablet. Setiap paket berisi properti ini secara default. Asal (0,0) tablet adalah sudut kiri atas.
STR_GUID_Z atau GUID_PACKETPROPERTY_GUID_Z
 Koordinat z atau jarak ujung pena dari permukaan tablet. Jenis enumerasi TabletPropertyMetricUnit menentukan satuan pengukuran untuk properti ini.
STR_GUID_PAKETSTATUS atau GUID_PACKETPROPERTY_GUID_PACKET_STATUS
 Berisi satu atau beberapa nilai bendera berikut:
  • Kursor menyentuh permukaan gambar (Nilai = 1).
  • Kursor terbalik. Misalnya, ujung penghapus pena menunjuk ke permukaan (Nilai = 2).
  • Tidak digunakan (Nilai = 4).
  • Tombol barel ditekan (Nilai = 8).
STR_GUID_TIMERTICK atau GUID_PACKETPROPERTY_GUID_TIMER_TICK
 Waktu paket dihasilkan.
STR_GUID_TIMERTICK atau GUID_PACKETPROPERTY_GUID_TIMER_TICK
 Waktu paket dihasilkan.
STR_GUID_SERIALNUMBER atau GUID_PACKETPROPERTY_GUID_SERIAL_NUMBER
 Properti paket untuk mengidentifikasi paket.
Ini adalah nilai yang sama dengan yang Anda gunakan untuk mengambil paket dari antrean paket.
STR_GUID_NORMALPRESSURE atau GUID_PACKETPROPERTY_GUID_NORMAL_PRESSURE
 Tekanan ujung pena yang tinggi terhadap permukaan tablet.
Semakin besar tekanan pada ujung pena, semakin banyak tinta yang digambar.
STR_GUID_TANGENTPRESSURE atau GUID_PACKETPROPERTY_GUID_TANGENT_PRESSURE
 Tekanan ujung pena di sepanjang bidang permukaan tablet.
STR_GUID_BUTTONPRESSURE atau GUID_PACKETPROPERTY_GUID_BUTTON_PRESSURE
 Tekanan pada tombol sensitif tekanan.
STR_GUID_XTILTORIENTATION atau GUID_PACKETPROPERTY_GUID_X_TILT_ORIENTATION
 Sudut antara bidang y,z dan pena dan bidang sumbu y.
Berlaku untuk kursor pena.
Nilainya adalah 0 ketika pena sangat bergantung pada permukaan gambar dan positif ketika pena berada di sebelah kanan yang ditentukan.
STR_GUID_YTILTORIENTATION atau GUID_PACKETPROPERTY_GUID_Y_TILT_ORIENTATION
 Sudut antara bidang x,z dan pena dan bidang sumbu x.
Berlaku untuk kursor pena.
Nilainya adalah 0 ketika pena tegak lurus dengan permukaan gambar dan positif ketika pena ke atas atau jauh dari pengguna.
STR_GUID_AZIMUTHORIENTATION atau GUID_PACKETPROPERTY_GUID_AZIMUTH_ORIENTATION
 Rotasi searah jajar kursor tentang sumbu z melalui rentang melingkar penuh.
STR_GUID_ALTITUDEORIENTATION atau GUID_PACKETPROPERTY_GUID_ALTITUDE_ORIENTATION
 Sudut antara sumbu pena dan permukaan tablet.
Nilainya adalah 0 ketika pena sejajar dengan permukaan dan 90 ketika pena dipendikskan ke permukaan.
Nilainya negatif ketika pena terbalik.
STR_GUID_TWISTORIENTATION atau GUID_PACKETPROPERTY_GUID_TWIST_ORIENTATION
 Rotasi searah jajar kursor tentang sumbunya sendiri.
STR_GUID_PITCHROTATION atau GUID_PACKETPROPERTY_GUID_PITCH_ROTATION
 Properti paket yang menunjukkan apakah ujung di atas atau di bawah garis horizontal yang tegak lurus dengan permukaan penulisan.
Catatan: Ini membutuhkan digitizer 3D.
Nilainya positif jika tip berada di atas garis dan negatif jika berada di bawah baris. Misalnya, jika Anda memegang pena di depan Anda dan menulis di dinding imajiner, nada positif jika ujungnya di atas garis yang memanjang dari Anda ke dinding.
STR_GUID_ROLLROTATION atau GUID_PACKETPROPERTY_GUID_ROLL_ROTATION
 Rotasi searah jajar pena di sekitar sumbunya sendiri.
Catatan: Ini membutuhkan digitizer 3D.
STR_GUID_YAWROTATION atau GUID_PACKETPROPERTY_GUID_YAW_ROTATION
 Sudut pena ke kiri atau kanan di sekitar tengah sumbu horizontalnya saat pena horizontal.
Catatan: Ini membutuhkan digitizer 3D.
Jika Anda memegang pena di depan Anda dan menulis di dinding imajiner, nol yaw menunjukkan bahwa pena tegak lurus pada dinding. Nilainya negatif jika ujungnya berada di sebelah kiri yang tidak dapat dibedakan dan positif jika ujungnya berada di sebelah kanan yang kesungguhan.
STR_GUID_YAWROTATION atau GUID_PACKETPROPERTY_GUID_YAW_ROTATION
 Sudut pena ke kiri atau kanan di sekitar tengah sumbu horizontalnya saat pena horizontal.
Catatan: Ini membutuhkan digitizer 3D.
Jika Anda memegang pena di depan Anda dan menulis di dinding imajiner, nol yaw menunjukkan bahwa pena tegak lurus pada dinding. Nilainya negatif jika ujungnya berada di sebelah kiri yang tidak dapat dibedakan dan positif jika ujungnya berada di sebelah kanan yang kesungguhan.
STR_GUID_WIDTH atau GUID_PACKETPROPERTY_GUID_WIDTH
 Lebar area kontak pada digitizer sentuh.
STR_GUID_HEIGHT atau GUID_PACKETPROPERTY_GUID_HEIGHT
 Tinggi area kontak pada digitizer sentuh.
STR_GUID_FINGERCONTACTCONFIDENCE atau GUID_PACKETPROPERTY_GUID_FINGERCONTACTCONFIDENCE
 Tingkat keyakinan bahwa ada kontak jari pada digitizer sentuh.
STR_GUID_DEVICE_CONTACT_ID atau GUID_PACKETPROPERTY_GUID_DEVICE_CONTACT_ID
 Pengidentifikasi kontak perangkat untuk paket.

Keterangan

Catatan

Semua nilai paket yang berasal dari perangkat keras tablet adalah bilangan bulat ukuran 32-bit.

 

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 (juga memerlukan Msinkaut_i.c)

Lihat juga

Metode IsPacketPropertySupported

Metode GetPropertyMetrics

Antarmuka IInkTablet