IInkDisp::Metode simpan (msinkaut.h)

Artikel
03/05/2024

Mengonversi tinta ke InkPersistenceFormat yang ditentukan, menyimpan tinta dengan menggunakan InkPersistenceCompressionMode yang ditentukan, dan mengembalikan data biner dalam array byte.

Sintaks

HRESULT Save(
  [in, optional] InkPersistenceFormat          PersistenceFormat,
  [in, optional] InkPersistenceCompressionMode CompressionMode,
  [out, retval]  VARIANT                       *Data
);

Parameter

[in, optional] PersistenceFormat

Opsional. Mengatur salah satu nilai InkPersistenceFormat yang menunjukkan format tinta yang bertahan. Nilai defaultnya adalah InkSerializedFormat.

Nama	Deskripsi
InkSerializedFormat	Tinta dipertahankan menggunakan format serial tinta (ISF). Ini adalah representasi tinta yang paling ringkas. Ini dapat disematkan dalam format dokumen biner atau ditempatkan langsung di Clipboard. Ini adalah nilai default.
Base64InkSerializedFormat	Tinta bertahan dengan mengodekan ISF sebagai aliran base64. Format ini disediakan sehingga tinta dapat dikodekan langsung dalam file Extensible Markup Language (XML) atau HTML.
Gif	Tinta bertahan dengan menggunakan file Graphics Interchange Format (GIF) yang berisi ISF sebagai metadata yang disematkan dalam file. Ini memungkinkan tinta untuk dilihat dalam aplikasi yang tidak mendukung tinta dan mempertahankan keakuratan tinta penuhnya ketika kembali ke aplikasi yang mendukung tinta. Format ini sangat ideal saat mengangkut konten tinta dalam file HTML dan membuatnya dapat digunakan oleh aplikasi yang mendukung tinta dan tidak menyadari tinta.
Base64Gif	Tinta bertahan dengan menggunakan fortified yang dikodekan base64. GIFformat ini disediakan ketika tinta akan dikodekan langsung dalam file XML atau HTML dengan konversi nanti menjadi gambar. Kemungkinan penggunaan ini akan berada dalam format XML yang dihasilkan untuk berisi semua informasi tinta dan digunakan sebagai cara untuk menghasilkan HTML melalui Transformasi Bahasa Lembar Gaya yang Dapat Diperluas (XSLT).

[in, optional] CompressionMode

Pilihan. Salah satu nilai InkPersistenceCompressionMode yang menentukan mode pemadatan tinta yang bertahan. Nilai defaultnya adalah IPCM_Default.

Nama	Deskripsi
IPCM_Default	Digunakan ketika tradeoff terbaik antara menghemat waktu dan penyimpanan untuk aplikasi umum diperlukan.
IPCM_MaximumCompression	Digunakan saat meminimalkan ruang penyimpanan lebih penting daripada seberapa cepat tinta disimpan.
IPCM_NoCompression	Digunakan ketika menghemat waktu lebih penting daripada jumlah ruang penyimpanan yang digunakan dan ketika kompatibilitas antar versi penting.

[out, retval] Data

Ketika metode ini kembali, berisi array byte yang berisi tinta yang bertahan.

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

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Parameter berisi penunjuk yang tidak valid.
E_INK_EXCEPTION	Pengecualian terjadi di dalam metode .
E_INVALIDARG	Mode pemadatan tidak valid.
E_OUTOFMEMORY	Tidak dapat mengalokasikan array byte.
E_UNEXPECTED	Terjadi jika Anda mencoba menyimpan objek Tinta kosong dalam format GIF.

Keterangan

Mencoba menyimpan objek InkDisp kosong dalam format GIF menghasilkan kesalahan.

Catatan Saat memanggil metode Simpan dengan nilai InkPersistenceFormat dari Base64InkSerializedFormat, nilai yang dikembalikan adalah array byte yang dihentikan NULL . Untuk menulis tinta yang disimpan ke file XML, pertama-tama hapus byte terakhir dari array sebelum mengonversi string yang dikodekan array menjadi Format Transformasi Unicode 8-bit (UTF-8).

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