Kelas InkOverlay

Artikel
06/13/2023

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:

Peristiwa
Antarmuka
Metode
Properti

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.