Kelas InkOverlay
Mewakili objek yang berguna untuk skenario anotasi di mana pengguna tidak peduli dengan melakukan pengenalan pada tinta tetapi sebaliknya tertarik pada ukuran, bentuk, warna, dan posisi tinta.
Membuat kontrol InkOverlay di belakang kontrol transparan (seperti GroupBox dengan kumpulan properti WS_EX_TRANSPARENT) akan mencegah InkOverlay mengumpulkan tinta .
InkOverlay memiliki jenis anggota ini:
Acara
Kelas InkOverlay memiliki peristiwa ini.
Kejadian | Deskripsi |
---|---|
CursorButtonDown | Terjadi ketika InkOverlay mendeteksi tombol kursor yang sedang tidak berfungsi. |
CursorButtonUp | Terjadi ketika InkOverlay mendeteksi tombol kursor yang aktif. |
KursorUnduh | Terjadi ketika tip kursor menghubungi permukaan tablet digitalisasi. |
CursorInRange | Terjadi ketika kursor memasuki rentang deteksi fisik (kedekatan) konteks tablet. |
CursorOutOfRange | Terjadi ketika kursor meninggalkan rentang deteksi fisik (kedekatan) konteks tablet. |
Doubleclick | Terjadi ketika objek InkOverlay diklik dua kali. |
Gerakan | Terjadi ketika gerakan khusus aplikasi dikenali. |
MouseDown | Terjadi ketika penunjuk mouse berada di atas objek InkOverlay dan tombol mouse ditekan. |
MouseMove | Terjadi ketika penunjuk mouse dipindahkan di atas objek InkOverlay . |
MouseUp | Terjadi ketika penunjuk mouse berada di atas objek InkOverlay dan tombol mouse dilepaskan. |
MouseWheel | Terjadi ketika roda mouse bergerak saat objek InkOverlay memiliki fokus. |
NewInAirPackets | Terjadi ketika paket dalam udara terlihat, yang terjadi ketika pengguna memindahkan pena di dekat tablet dan kursor berada dalam jendela objek InkOverlay atau pengguna memindahkan mouse dalam jendela terkait objek InkOverlay . |
NewPackets | Terjadi ketika objek InkOverlay menerima paket. |
Dicat | Terjadi ketika objek InkOverlay telah selesai digambar ulang itu sendiri. |
Lukisan | Terjadi sebelum objek InkOverlay digambar ulang sendiri. |
SelectionChanged | Terjadi ketika pemilihan tinta dalam kontrol telah berubah, seperti melalui perubahan pada antarmuka pengguna, prosedur potong dan tempel, atau properti Pilihan . |
Pemilihan Pertukaran | Terjadi ketika pemilihan tinta dalam kontrol akan berubah, seperti melalui perubahan pada antarmuka pengguna, prosedur potong dan tempel, atau properti Pilihan . |
SelectionMoved | Terjadi ketika posisi pilihan saat ini telah berubah, seperti melalui perubahan pada antarmuka pengguna, prosedur potong dan tempel, atau properti Pilihan . |
PemilihanMoving | Terjadi ketika posisi pilihan saat ini akan berubah, seperti melalui perubahan pada antarmuka pengguna, prosedur potong dan tempel, atau properti Pilihan . |
SelectionResized | Terjadi ketika ukuran pilihan saat ini telah berubah, seperti melalui perubahan pada antarmuka pengguna, prosedur potong dan tempel, atau properti Pilihan . |
SelectionResizing | Terjadi ketika ukuran pilihan saat ini akan berubah, seperti melalui perubahan pada antarmuka pengguna, prosedur potong dan tempel, atau properti Pilihan . |
Usap | Terjadi ketika pengguna selesai menggambar stroke baru pada tablet apa pun. |
StrokesDeleted | Terjadi setelah stroke dihapus dari properti Tinta . |
StrokesDeleting | Terjadi sebelum stroke dihapus dari properti Tinta . |
SystemGesture | Terjadi ketika gerakan sistem dikenali. |
TabletTambahkan | Terjadi ketika IInkTablet ditambahkan ke sistem. |
TabletRemoved | Terjadi ketika Tablet dihapus dari sistem. |
Antarmuka
Kelas InkOverlay mendefinisikan antarmuka ini.
Antarmuka | Deskripsi |
---|---|
IInkOverlay | Objek ini mengimplementasikan antarmuka IInkOverlay COM. |
Metode
Kelas InkOverlay memiliki metode ini.
Metode | Deskripsi |
---|---|
Tarik | Mengatur persegi panjang untuk menggambar ulang tinta dalam objek InkOverlay . |
GetEventInterest | Mengembalikan status saat ini dari peristiwa objek InkOverlay tertentu, yaitu, apakah peristiwa sedang didengarkan atau digunakan. |
GetGestureStatus | Mengembalikan apakah objek InkOverlay tertarik dengan gerakan tertentu. |
GetWindowInputRectangle | Mengambil persegi panjang jendela, dalam piksel, di mana tinta digambar. |
HitTestSelection | Menentukan bagian pemilihan apa yang terpukul selama tes hit. |
SetAllTabletsMode | Mode ini memungkinkan objek InkOverlay mengumpulkan tinta dari tablet apa pun yang terpasang pada PC Tablet. |
SetEventInterest | Mengatur apakah peristiwa tertentu harus didengarkan atau digunakan. |
SetGestureStatus | Mengatur minat objek InkOverlay dalam gerakan yang diketahui. |
SetSingleTabletIntegratedMode | Mode ini memungkinkan objek InkOverlay mengumpulkan tinta hanya dari satu tablet. Tinta dari tablet lain diabaikan oleh objek InkOverlay . |
SetWindowInputRectangle | Mengatur persegi panjang jendela, dalam piksel, untuk digunakan untuk memetakan tinta yang digambar ke jendela. |
Properti
Kelas InkOverlay memiliki properti ini.
Properti | Jenis akses | Deskripsi |
---|---|---|
AttachMode |
Baca/Tulis |
Mendapatkan atau mengatur nilai yang menentukan apakah objek InkOverlay dilampirkan di belakang atau di depan jendela yang diketahui. |
AutoRedraw |
Baca/Tulis |
Mendapatkan atau menetapkan nilai yang menentukan apakah InkOverlay mengecat ulang tinta saat jendela tidak valid. |
CollectingInk |
Baca-saja |
Mendapatkan nilai yang menentukan apakah tinta saat ini sedang digambar pada objek InkOverlay . |
CollectionMode |
Baca/Tulis |
Mendapatkan atau mengatur mode koleksi yang menentukan apakah tinta, gerakan, atau keduanya dikenali saat pengguna menulis. |
Kursor |
Baca-saja |
Mendapatkan koleksi Kursor yang tersedia untuk digunakan di wilayah penintaan. |
DefaultDrawingAttributes |
Baca/Tulis |
Mendapatkan atau mengatur objek InkDrawingAttributes default, yang menentukan atribut gambar yang digunakan saat menggambar dan menampilkan tinta. |
DesiredPacketDescription |
Baca/Tulis |
Mendapatkan atau menetapkan minat pada aspek paket yang terkait dengan tinta yang digambar pada objek InkOverlay . |
DynamicRendering |
Baca/Tulis |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah tinta dirender saat digambar. |
EditingMode |
Baca/Tulis |
Mendapatkan atau mengatur nilai yang menunjukkan apakah InkOverlay berada dalam mode tinta, mode penghapusan, atau mode pemilihan/pengeditan. |
Aktif |
Baca/Tulis |
Mendapatkan atau menetapkan nilai yang menentukan apakah objek InkOverlay mengumpulkan input pena. |
EraserMode |
Baca/Tulis |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah tinta dihapus oleh goresan atau berdasarkan titik. |
EraserWidth |
Baca/Tulis |
Mendapatkan atau menetapkan nilai yang menentukan lebar ujung pena penghapus. |
Handle |
Baca/Tulis |
Mendapatkan atau mengatur handel jendela tempat objek InkOverlay dilampirkan. |
Tinta |
Baca/Tulis |
Mendapatkan atau mengatur objek InkDisp yang terkait dengan objek InkOverlay . |
MarginX |
Baca/Tulis |
Mendapatkan atau mengatur margin di sepanjang sumbu x, dalam piksel. |
Marginy |
Baca/Tulis |
Mendapatkan atau mengatur margin di sepanjang sumbu y, dalam piksel. |
MouseIcon |
Baca/Tulis |
Mendapatkan atau mengatur ikon mouse kustom saat ini. |
MousePointer |
Baca/Tulis |
Mendapatkan atau mengatur nilai yang menunjukkan jenis penunjuk mouse yang muncul saat mouse berada di atas bagian objek tertentu. |
Renderer |
Baca/Tulis |
Mendapatkan atau mengatur objek InkRenderer yang digunakan untuk menggambar tinta. |
Pilihan |
Baca/Tulis |
Mendapatkan atau mengatur koleksi InkStrokes yang saat ini dipilih di dalam kontrol InkOverlay . |
SupportHighContrastInk |
Baca/Tulis |
Mendapatkan atau menetapkan nilai yang menentukan apakah tinta dirender hanya sebagai satu warna ketika sistem berada dalam mode Kontras Tinggi. |
SupportHighContrastSelectionUI |
Baca/Tulis |
Mendapatkan atau menetapkan nilai yang menentukan apakah semua UI pilihan digambar dengan kontras tinggi saat sistem berada dalam mode Kontras Tinggi. |
Tablet |
Baca-saja |
Mendapatkan perangkat tablet yang saat ini digunakan objek InkOverlay untuk mengumpulkan input. |
Catatan Implementasi MFC
Jika Anda melampirkan objek InkOverlay ke objek CView, rilis objek InkOverlay sebagai respons terhadap pesan WM_DESTROY seperti yang ditunjukkan dalam contoh berikut:
BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
if(WM_DESTROY == msg)
m_spInkOverlay.Release();
return CView::OnWndMsg(msg, wp, lp, pLR);
}
Keterangan
Objek ini dapat dibuat dengan memanggil metode CoCreateInstance di C++.
Objek InkOverlay sangat cocok untuk pengambilan catatan dan penulisan dasar. Penggunaan utama yang dimaksudkan dari objek ini adalah untuk menampilkan tinta sebagai tinta.
Secara umum, antarmuka pengguna run-time untuk objek ini adalah jendela transparan dengan tinta buram.
Peristiwa MouseDown, MouseMove, MouseUp, dan MouseWheel mengembalikan koordinat x dan koordinat y dalam piksel, dan bukan unit HIMETRIC yang terkait dengan ruang tinta. Ini karena peristiwa ini menggantikan peristiwa mouse aplikasi yang tidak sadar pena dan aplikasi ini hanya memahami piksel.
Perhatian
Jika Anda mengatur properti AttachMode objek InkOverlay ke InFront, buat objek InkOverlay di utas tempat formulir dijalankan. Aplikasi Anda mungkin berhenti merespons jika objek InkOverlay dibuat di utas yang berbeda dan properti AttachMode-nya diatur ke InFront.
Catatan
Objek InkOverlay tidak dapat dirilis dengan aman pada utas non-UI.
Untuk meningkatkan performa aplikasi Anda, buang objek InkOverlay Anda saat tidak lagi diperlukan.
Jika Anda melampirkan objek InkOverlay ke objek CView, rilis objek InkOverlay sebagai respons terhadap pesan WM_DESTROY seperti yang ditunjukkan dalam contoh berikut:
BOOL CRecognitionAlternatesSampleCppView::OnWndMsg(UINT msg, WPARAM wp, PARAM lp, LRESULT *pLR)
{
if(WM_DESTROY == msg)
m_spInkOverlay.Release();
return CView::OnWndMsg(msg, wp, lp, pLR);
}
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows XP Tablet PC Edition [hanya aplikasi desktop] |
Server minimum yang didukung |
Tidak ada yang didukung |
Header |
|
Pustaka |
|