Referensi Kontrol Gambar Tinta
Kontrol InkPicture menyediakan kemampuan untuk menempatkan gambar dalam aplikasi dan memungkinkan pengguna untuk menambahkan tinta di atasnya. Ini ditujukan untuk skenario di mana tinta tidak dikenali sebagai teks tetapi malah disimpan sebagai tinta.
Kontrol InkPicture dapat dibuat dengan memanggil metode CoCreateInstance di C++.
Catatan
Kontrol InkPicture tidak ditandai aman untuk pembuatan skrip. Kontrol InkPicture tidak boleh digunakan dalam html atau halaman ASP.NET.
Membuat kontrol InkPicture di balik kontrol transparan (seperti GroupBox dengan set properti WS_EX_TRANSPARENT) akan mencegah InkPicture mengumpulkan tinta.
Anggota
| Enumeration | Deskripsi |
|---|---|
| InkPictureSizeMode | Menentukan nilai yang menentukan perilaku gambar latar belakang di dalam kontrol InkPicture. |
| Kejadian | Deskripsi |
|---|---|
| ChangeUICues | Dihentikan. |
| Klik | Terjadi ketika pengguna mengklik kontrol InkPicture. |
| Peristiwa CursorButtonDown | Terjadi ketika kontrol InkCollector mendeteksi objek IInkCursorButton yang sedang tidak berfungsi. |
| Peristiwa CursorButtonUp | Terjadi ketika kontrol InkPicture mendeteksi IInkCursorButton yang aktif. |
| Peristiwa CursorDown | Terjadi ketika tip kursor menghubungi permukaan tablet digitalisasi. |
| Peristiwa CursorInRange | Terjadi ketika kursor memasuki rentang deteksi fisik (kedekatan) konteks tablet. |
| Peristiwa CursorOutOfRange | Terjadi ketika kursor meninggalkan rentang deteksi fisik (kedekatan) konteks tablet. |
| DblClick | Terjadi ketika kontrol InkPicture diklik dua kali. Metode kejadian ini didefinisikan dalam antarmuka _IInkPictureEvents . Antarmuka _IInkPictureEvents mengimplementasikan antarmuka IDispatch dengan pengidentifikasi DISPID_IPEDblClick. |
| Peristiwa Gerakan | Terjadi ketika gerakan aplikasi dikenali. |
| Peristiwa KeyDown [Kontrol Gambar Tinta] | Terjadi ketika tombol ditekan dan dalam posisi bawah sementara kontrol InkPicture memiliki fokus. |
| KeyPress Event[InkPicture Control] | Terjadi ketika tombol ditekan saat kontrol InkPicture memiliki fokus. |
| Peristiwa KeyUp [Kontrol Gambar Tinta] | Terjadi ketika kunci dilepaskan saat kontrol InkPicture memiliki fokus. |
| Peristiwa MouseDown [Kontrol Gambar Tinta] | Terjadi ketika penunjuk mouse berada di atas kontrol InkPicture dan tombol mouse ditekan. |
| MouseEnter | Terjadi ketika penunjuk mouse memasuki kontrol InkPicture. |
| MouseHover | Terjadi ketika penunjuk mouse mengarah ke kontrol InkPicture. |
| MouseLeave | Terjadi ketika penunjuk mouse meninggalkan kontrol InkPicture. |
| MouseMove Event [InkPicture Control] | Terjadi ketika penunjuk mouse dipindahkan melalui kontrol InkPicture. |
| Kejadian MouseUp [Kontrol Gambar Tinta] | Terjadi ketika penunjuk mouse berada di atas kontrol InkPicture dan tombol mouse dilepaskan. |
| MouseWheel | Terjadi ketika roda tetikus bergerak sementara kontrol InkPicture memiliki fokus. |
| Kejadian NewInAirPackets | Terjadi ketika paket dalam udara terlihat. |
| Kejadian NewPackets | Terjadi ketika kontrol InkPicture menerima paket. |
| Dicat | Terjadi ketika kontrol InkPicture telah selesai menggambar ulang dirinya sendiri. |
| Lukisan | Terjadi sebelum kontrol InkPicture menggambar ulang dirinya sendiri. |
| Mengubah ukuran | Terjadi ketika kontrol InkPicture diubah ukurannya. |
| SelectionChanged | Terjadi ketika pemilihan teks dalam kontrol InkPicture telah berubah, seperti melalui perubahan pada antarmuka pengguna, prosedur potong dan tempel, atau properti Pilihan . |
| Pemilihan Pertukaran | Terjadi ketika pemilihan teks dalam kontrol InkPicture 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 . |
| SelectionMoving Event [InkPicture Control] | 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 . |
| SizeChanged | Terjadi setelah kontrol InkPicture diubah ukurannya, khususnya, setelah nilai properti Lebar atau Tinggi berubah. |
| SizeModeChanged | Terjadi setelah properti SizeMode kontrol InkPicture telah diubah. |
| StyleChanged | Tidak diterapkan. |
| Usap | Terjadi ketika pengguna menggambar stroke baru pada tablet apa pun. |
| StrokesDeleted | Terjadi setelah objek IInkStrokeDisp dihapus dari properti Tinta . |
| StrokesDeleting | Terjadi sebelum objek IInkStrokeDisp dihapus dari properti Tinta . |
| SystemColorsChanged | Terjadi setelah warna sistem berubah. |
| SystemGesture | Terjadi ketika gerakan sistem dikenali. |
| Peristiwa Yang Ditambatkan Tablet | Terjadi ketika tablet ditambahkan ke sistem. |
| Peristiwa TabletRemoved | Terjadi ketika tablet dihapus dari sistem. |
| Metode | Deskripsi |
|---|---|
| Metode GetEventInterest | Mengembalikan nilai yang menunjukkan apakah kontrol InkPicture memiliki minat pada peristiwa tertentu. |
| GetGestureStatus | Mengembalikan nilai yang menunjukkan apakah kontrol InkPicture memiliki minat pada gerakan aplikasi tertentu. |
| Metode GetWindowInputRectangle | Mengembalikan persegi panjang jendela, dalam piksel, di mana tinta digambar. |
| HitTestSelection | Mengembalikan anggota enumerasi SelectionHitResult , yang menentukan bagian mana dari pilihan, jika ada, yang ditemui selama pengujian temuan. |
| Metode SetAllTabletsMode | Memungkinkan kontrol InkPicture untuk mengumpulkan tinta dari tablet apa pun yang terpasang pada PC Tablet. |
| Metode SetEventInterest | Menetapkan nilai yang menunjukkan apakah kontrol InkPicture memiliki minat pada peristiwa tertentu. |
| SetFocus | Memindahkan fokus ke kontrol InkPicture. |
| Metode SetGestureStatus | Mengatur minat objek InkPicture dalam gerakan aplikasi tertentu. |
| Metode SetSingleTabletIntegratedMode | Mengatur kontrol InkPicture untuk mengumpulkan tinta hanya dari satu tablet yang terpasang pada PC Tablet. Tinta dari tablet lain diabaikan. |
| Metode SetWindowInputRectangle | Menentukan persegi jendela yang akan diatur, dalam koordinat jendela, di mana tinta digambar. |
| ShowWhatsThis | Menampilkan topik terpilih dalam file Bantuan menggunakan popup "Apa Ini" yang disediakan oleh Bantuan dalam sistem operasi Microsoft Windows 32-bit (hanya waktu desain). |
| ZOrder | Menempatkan kontrol di depan atau belakang urutan z dalam tingkat grafisnya (hanya waktu desain). |
| Properti | Deskripsi |
|---|---|
| Properti AutoRedraw | Mendapatkan atau mengatur nilai yang menentukan apakah kontrol InkPicture dicat ulang saat jendela tidak valid (apakah objek InkDisp yang saat ini terkait dengan kontrol InkPicture secara otomatis digambar ulang ketika jendela yang terkait dengan InkPicture menerima pesan WM_PAINT). |
| Warna Belakang | Mendapatkan atau mengatur warna latar belakang untuk kontrol InkPicture. Warna latar belakang default adalah warna latar belakang jendela sistem, yang biasanya putih. |
| Mengumpulkan PropertiInk | Mendapatkan nilai yang menentukan apakah kontrol InkPicture mengumpulkan tinta (hanya durasi). |
| CollectionMode | Mendapatkan atau mengatur mode koleksi yang menentukan apakah tinta, gerakan, atau tinta dan gerakan dikenali saat pengguna menulis. |
| Properti Kursor | Mendapatkan koleksi IInkCursors yang tersedia untuk digunakan di wilayah tinta kontrol InkPicture. |
| CustomStrokes | Mendapatkan koleksi IInkCustomStrokes untuk dipertahankan dengan tinta (hanya waktu desain). |
| Properti DefaultDrawingAttributes | Mendapatkan atau mengatur koleksi InkDrawingAttributes default untuk digunakan saat menggambar dan menampilkan tinta (hanya run time). |
| Properti DesiredPacketDescription | Mendapatkan atau mengatur deskripsi paket kontrol InkPicture (hanya durasi). |
| Properti DynamicRendering | Mendapatkan atau mengatur nilai yang menentukan apakah kontrol InkPicture merender tinta secara dinamis saat dikumpulkan. |
| EditingMode | Mendapatkan atau mengatur nilai yang menentukan apakah kontrol InkPicture berada dalam mode tinta, mode penghapusan, atau mode pemilihan/pengeditan. |
| Aktif | Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol InkPicture dapat merespons peristiwa yang dihasilkan pengguna. Catatan: Properti ini setara dengan properti InkEnabled . |
| EraserMode | Mendapatkan atau menetapkan nilai yang menentukan apakah tinta dihapus oleh stroke atau berdasarkan titik. |
| EraserWidth | Mendapatkan atau mengatur nilai yang menentukan lebar tip penghapus pena. |
| hWnd | Mendapatkan handel jendela tempat kontrol InkPicture terikat. (run time saja) |
| Tinta | Mendapatkan atau mengatur objek InkDisp yang terkait dengan kontrol InkPicture (run time saja). |
| InkEnabled | Mendapatkan atau menetapkan nilai yang menentukan apakah kontrol InkPicture mengumpulkan input pena (paket dalam udara, kursor dalam peristiwa rentang, dan sebagainya). |
| Properti MarginX | Mendapatkan atau mengatur margin sumbu x di sekitar persegi jendela dalam koordinat layar. |
| Properti Marginy | Mendapatkan atau mengatur margin sumbu y di sekitar persegi jendela dalam koordinat layar. |
| Properti MouseIcon | Mendapatkan atau mengatur ikon mouse kustom saat ini. |
| Properti MousePointer | Mendapatkan atau mengatur nilai yang menunjukkan jenis penunjuk mouse yang muncul saat mouse berada di atas bagian tertentu dari kontrol InkPicture. |
| Gambar | Mendapatkan file grafis untuk muncul pada kontrol InkPicture. |
| Properti Perender | Mendapatkan atau mengatur objek InkRenderer yang digunakan untuk menggambar tinta pada kontrol InkPicture (hanya durasi). |
| Pilihan | Mendapatkan koleksi InkStrokes yang saat ini dipilih di dalam kontrol InkPicture (hanya run time). |
| SizeMode | Mendapatkan atau mengatur cara kontrol menangani penempatan dan ukuran gambar. |
| Properti SupportHighContrastInk | Mendapatkan nilai yang menentukan apakah tinta dirender hanya sebagai satu warna, Warna = COLOR_WINDOWTEXT (dari panggilan GetSystemMetrics) saat sistem berada dalam mode Kontras Tinggi. |
| SupportHighContrastSelectionUI | Mendapatkan atau mengatur nilai yang menentukan apakah semua antarmuka pengguna pilihan (kotak pembatas pilihan dan gagang pemilihan) digambar dengan kontras tinggi saat sistem berada dalam mode Kontras Tinggi. |
| Properti Tablet | Mendapatkan objek IInkTablet yang saat ini digunakan kontrol InkPicture untuk mengumpulkan input. |
Keterangan
Antarmuka pengguna run time untuk kontrol InkPicture adalah jendela dengan latar belakang buram (warna tunggal, latar belakang gambar, atau keduanya) yang berisi tinta buram.
Anda dapat menggunakan kontrol InkPicture untuk merender tinta di Microsoft Windows 2000, Windows Server 2003, edisi Windows XP apa pun selain Windows XP Tablet PC Edition, dan versi Windows Vista apa pun. Namun, Anda dapat memasukkan tinta, menerima gerakan, atau mengenali tulisan tangan hanya dalam kondisi berikut:
- Tinta dapat dimasukkan dan dikenali jika Windows Vista atau XP Tablet PC Edition 2005 diinstal.
- Gerakan juga dapat dikenali.
- Tulisan tangan dapat dikenali sebagai teks jika tulisan tangan berasal dari mesin yang menjalankan versi Windows yang lebih lama selama pengenal ada.
Jika Anda menggunakan Windows 2000, Windows Server 2003, edisi Windows XP apa pun selain Windows XP Tablet PC Edition 2005, Anda dapat menetapkan nilai ke properti sekitar kontrol InkPicture, lalu menyalin dan menempelkan tinta ke aplikasi lain. Namun, nilai properti InkEnabled-nya akan selalu FALSE.
Objek InkDisp persisten dapat dimuat dan ditampilkan pada semua edisi Windows Vista dan XP dan pada sistem yang hanya menginstal Windows XP Tablet PC Edition Software Development Kit (SDK). Objek InkDisp hanya dapat dikonversi ke teks (dikenali), jika Windows Vista atau Windows XP Tablet PC Edition 2005 diinstal.
Jika operasi pada kontrol ini tidak berhasil, HRESULT hukum akan dikembalikan. Jika kondisi kesalahan menghasilkan, periksa HRESULT yang dikembalikan terhadap kesalahan.
Untuk informasi selengkapnya tentang kontrol tinta, lihat Tinta.
Untuk informasi tentang utas mana yang meningkatkan peristiwa tertentu, lihat Utas di Mana Peristiwa Dapat Diaktifkan.
Untuk meningkatkan performa aplikasi Anda, buang kontrol InkPicture secara manual saat tidak lagi diperlukan.
Catatan
Ketika kontrol InkPicture dilapisi dengan kontrol lain, seperti GroupBox yang diatur ke transparan, InkPicture tidak akan mengumpulkan tinta. InkPicture harus menjadi kontrol terbanyak dalam urutan Z atau harus anak dari GroupBox.
Implementasi COM
Objek ini mengimplementasikan antarmuka IInkPicture COM.