IInkDisp::Muat metode (msinkaut.h)

Mengisi objek InkDisp baru dengan data biner yang diketahui.

Sintaks

HRESULT Load(
  [in] VARIANT Data
);

Parameter

[in] Data

Aliran yang berisi data tinta.

Untuk informasi selengkapnya tentang struktur VARIAN, lihat Menggunakan Pustaka COM.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_INVALIDARG	VARIAN bukan tipe yang benar (byte array).
E_OUTOFMEMORY	Tidak dapat mengalokasikan memori untuk Stream.
E_UNEXPECTED	Parameter atau jenis properti yang tidak terduga.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .

Keterangan

Anda hanya dapat memuat tinta ke objek InkDisp baru yang kosong - yang belum mengumpulkan goresan apa pun atau tidak memiliki properti terlampir. Jika Anda mencoba memuat tinta ke objek InkDisp yang telah mengumpulkan goresan atau properti terlampir, bahkan jika goresan atau properti telah dihapus dari objek InkDisp , pengecualian akan dilemparkan. Ini terjadi karena bagaimana ID stroke ditetapkan. Stroke diberi ID unik, dan ID ini tidak digunakan kembali, bahkan jika goresan telah dihapus dari objek Tinta. Ini berarti bahwa, jika objek InkDisp berisi goresan dengan ID 1 dan Anda menghapus goresan dan memuat objek InkDisp lain ke dalam objek InkDisp ini, ID goresan akan dimulai pada 2. Ini akan membingungkan dan oleh karena itu tidak diizinkan.

Catatan Jika Anda mencoba memuat tinta ke objek InkDisp yang tidak kosong, semua data di objek InkDisp , termasuk goresan kustom atau properti yang diperluas, hilang saat Anda memanggil Muat.

 

Metode Simpan memungkinkan Anda mempertahankan tinta dalam objek InkDisp dalam format Graphics Interchange Format (GIF), yang terdiri dari array data byte (format persistensi tla_gif ditentukan dalam jenis enumerasi InkPersistenceFormat ). Setelah Anda memiliki array data byte, Anda dapat memuat array data byte ke objek InkDisp lain. Ini berarti Anda dapat memuat data array byte yang kompatibel dengan GIF ke objek InkDisp lain dengan cara yang sama seolah-olah Anda telah memanggil metode Simpan dan menerima array byte yang tidak dalam format GIF.

Catatan Anda tidak dapat membuat gambar, mempertahankan gambar tersebut sebagai array byte, lalu memuat array byte tersebut ke objek InkDisp lain. Ini karena, setelah Anda memuat data array byte sebagai GIF, PC Tablet tidak dapat mengontrol format data tersebut. Jadi, setelah Anda mempertahankan gambar ke dalam array byte lagi, Anda tidak dapat memanggil Muat pada data tersebut.

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP Tablet PC Edition [hanya aplikasi desktop]
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	msinkaut.h
Pustaka	InkObj.dll

Lihat juga

IInkDisp

Kelas InkDisp

Metode Simpan