ITextDocument::Metode simpan (tom.h)

Artikel
08/26/2023

Menyimpan dokumen.

Sintaks

HRESULT Save(
  [in] VARIANT *pVar,
  [in] long    Flags,
  [in] long    CodePage
);

Parameter

[in] pVar

Jenis: VARIAN*

Target penyimpanan. Parameter ini adalah VARIAN, yang dapat berupa nama file, atau NULL.

[in] Flags

Jenis: panjang

Bendera pembuatan, buka, bagikan, dan konversi file. Untuk daftar nilai yang mungkin, lihat ITextDocument::Open.

[in] CodePage

Jenis: panjang

Halaman kode yang ditentukan. Nilai umum adalah CP_ACP (nol: halaman kode ANSI sistem), 1200 (Unicode), dan 1208 (UTF-8).

Nilai kembali

Jenis: HRESULT

Nilai yang dikembalikan dapat menjadi nilai HRESULT yang sesuai dengan kode kesalahan sistem atau kode kesalahan COM, termasuk salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_INVALIDARG	Argumen tidak valid.
E_OUTOFMEMORY	Memori tidak cukup.
E_NOTIMPL	Fitur tidak diimplementasikan.

Keterangan

Untuk menggunakan parameter yang ditentukan untuk membuka file, gunakan nilai nol untuk parameter.

Jika pVar null atau hilang, nama file yang diberikan oleh nama dokumen ini digunakan. Jika kedua hal ini hilang atau null, metode gagal.

Jika pVar menentukan nama file, nama tersebut harus menggantikan properti Nama saat ini. Demikian pula, argumen Flags dan CodePage dapat mengesampingkan yang disediakan dalam metode ITextDocument::Open dan menentukan nilai yang akan digunakan untuk file yang dibuat dengan metode ITextDocument::New .

File teks biasa Unicode harus disimpan dengan tanda urutan byte Unicode (0xFEFF) sebagai karakter pertama. Karakter ini harus dihapus ketika file dibaca; artinya, hanya digunakan untuk impor/ekspor untuk mengidentifikasi teks biasa sebagai Unicode dan untuk mengidentifikasi urutan byte teks tersebut. Microsoft Notepad mengadopsi konvensi ini, yang sekarang direkomendasikan oleh standar Unicode.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	tom.h
DLL	Msftedit.dll