Kelas InkDisp

  • Artikel

Mewakili goresan tinta yang dikumpulkan dalam ruang tinta.

InkDisp memiliki jenis anggota ini:

Acara

Kelas InkDisp memiliki peristiwa ini.

Kejadian Deskripsi
InkAdded Terjadi ketika stroke ditambahkan ke objek InkDisp .
InkDeleted Terjadi ketika stroke dihapus dari objek InkDisp .

Antarmuka

Kelas InkDisp mendefinisikan antarmuka ini.

Antarmuka Deskripsi
IInkDisp Objek ini mengimplementasikan antarmuka IInkDisp COM.

Metode

Kelas InkDisp memiliki metode ini.

Metode Deskripsi
AddStrokesAtRectangle Menyisipkan koleksi goresan ke dalam objek InkDisp pada persegi panjang yang ditentukan.
CanPaste Menunjukkan apakah IDataObject dapat dikonversi ke objek InkDisp .
Klip Menghilangkan sebagian goresan atau kumpulan goresan yang berada di luar persegi panjang.
ClipboardCopy Menyalin koleksi InkStrokes ke Clipboard.
ClipboardCopyWithRectangle Menyalin objek IInkStrokeDisp yang terkandung dalam persegi panjang yang diketahui ke Clipboard.
ClipboardPaste Menyalin IDataObject dari Clipboard ke objek InkDisp .
Kloning Membuat objek InkDisp duplikat.
CreateStroke Membuat stroke dari titik atau data paket.
CreateStrokes Membuat koleksi InkStrokes untuk objek InkDisp ini.
DeleteStroke Menghapus goresan dari objek InkDisp .
DeleteStrokes Menghapus goresan dari objek InkDisp .
Metode ExtractStrokes Mengekstrak goresan dari objek InkDisp dan mengembalikan objek InkDisp baru yang berisi goresan yang diekstrak.
Metode ExtractWithRectangle Memotong atau menyalin goresan dari objek Kelas InkDisp yang ada dan menempelkannya ke objek Kelas InkDisp baru, dengan menggunakan persegi yang diketahui untuk menentukan goresan mana yang akan diekstrak.
GetBoundingBox Mengambil kotak pembatas semua goresan di objek InkDisp .
HitTestCircle Mengambil koleksi InkStrokes yang sepenuhnya berada di dalam atau dipotong oleh lingkaran yang diketahui.
HitTestWithLasso Mengambil goresan dalam area pemilihan poliline.
HitTestWithRectangle Mengambil goresan yang terkandung dalam persegi panjang tertentu.
Muat Mengisi objek InkDisp baru dengan data biner yang diketahui.
Titik Terdekat Mengambil IInkStrokeDisp dalam objek InkDisp yang terdekat dengan titik yang diketahui, secara opsional memberikan informasi tambahan.
Simpan Mengonversi tinta ke format tertentu dan mengembalikan data biner.

Properti

Kelas InkDisp memiliki properti ini.

Properti Jenis akses Deskripsi
CustomStrokes
 Baca-saja
 Mendapatkan koleksi IInkCustomStrokes untuk dipertahankan dengan tinta.
Kotor
 Baca/Tulis
 Mendapatkan atau mengatur nilai yang menunjukkan apakah objek InkDisp telah dimodifikasi sejak terakhir kali tinta disimpan.
ExtendedProperties
 Baca-saja
 Mendapatkan pengumpulan data yang ditentukan aplikasi.
Stroke
 Baca-saja
 Mendapatkan koleksi InkStrokes yang terkandung dalam objek InkDisp .

Keterangan

Objek ini dapat dibuat dengan memanggil metode CoCreateInstance di C++.

Catatan

Instansiasi pertama objek ini menyebabkan GDI+ juga diinstansiasi. Efek samping adalah bahwa jika Anda menggunakan objek tinta tunggal dalam perulangan dan membuat dan menghancurkannya dalam perulangan, Anda akan menyebabkan GDI+ dibuat berulang-ulang. Ini dapat menyebabkan penurunan performa di aplikasi Anda. Untuk mencegah hal ini, simpan satu instans objek tinta setiap saat saat aplikasi Anda menggunakan tinta.

Objek InkDisp adalah kontainer data stroke (titik). Data goresan, atau titik yang dikumpulkan oleh pena, dimasukkan ke dalam objek InkDisp . Properti Strokes berisi data untuk semua goresan dalam objek InkDisp .

Objek InkCollector , objek InkOverlay , dan kontrol InkPicture mengumpulkan titik dari perangkat input dan memasukkannya ke dalam objek InkDisp . Objek-objek ini pada dasarnya bertindak sebagai sumber yang mendistribusikan tinta ke dalam satu atau banyak objek InkDisp yang berbeda, yang bertindak sebagai kontainer yang menyimpan tinta terdistribusi.

Ruang tinta adalah ruang koordinat virtual tempat koordinat konteks tablet dipetakan. Ruang ini diperbaiki ke sistem koordinat HIMETRIC. Dalam koordinat ruang tinta, perpindahan dari 0 ke 1 sama dengan 1 unit HIMETRIC. Pemetaan ini memudahkan untuk menghubungkan beberapa objek InkDisp .

Objek InkRenderer mengelola pemetaan antara tinta dan jendela tampilan.

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)
Pustaka
InkObj.dll

Lihat juga

Antarmuka IInkStrokeDisp

Koleksi InkStrokes

Antarmuka IInkTablet