ITextDocument::Metode buka (tom.h)

Artikel
03/02/2024

Membuka dokumen tertentu. Ada parameter untuk menentukan hak istimewa akses dan berbagi, pembuatan dan konversi file, serta halaman kode untuk file.

Sintaks

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

Parameter

[in] pVar

Jenis: VARIAN*

VARIAN yang menentukan nama file yang akan dibuka.

Flags

Jenis: panjang

Bendera pembuatan, buka, bagikan, dan konversi file. Nilai default adalah nol, yang memberikan akses baca/tulis dan berbagi baca/tulis, buka selalu, dan pengenalan otomatis format file (format file yang tidak dikenal diperlakukan sebagai teks). Nilai lain didefinisikan dalam grup berikut.

Kombinasi apa pun dari nilai-nilai ini dapat digunakan.

tomReadOnly

tomShareDenyRead

tomShareDenyWrite

tomPasteFile

Nilai-nilai ini saling eksklusif.

tomCreateNew

tomCreateAlways

tomOpenExisting

tomOpenAlways

tomTruncateExisting

tomRTF

tomText

tomHTML

tomWordDocument

CodePage

Jenis: panjang

Halaman kode yang digunakan untuk file. Nol (nilai default) berarti CP_ACP (halaman kode ANSI) kecuali file dimulai dengan 0XFEFF Unicode, dalam hal ini file dianggap Unicode. Perhatikan bahwa halaman kode 1200 adalah Unicode, CP_UTF8 adalah UTF-8.

Mengembalikan nilai

Jenis: HRESULT

Nilai yang dikembalikan dapat menjadi nilai HRESULT yang sesuai dengan 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

Jika dokumen dibuat dengan metode ITextDocument::Metode baru dan nilai nol digunakan, mesin Model Objek Teks (TOM) harus memilih bendera dan halaman kode mana yang akan digunakan. UTF-8 Rich Text Format (RTF) (didefinisikan di bawah) adalah default yang menarik.

Microsoft Rich Edit 3.0 mendefinisikan kata kontrol, \urtf8, yang harus digunakan alih-alih \rtf1. Ini berarti file dikodekan dalam UTF-8. Pada input, file RTF berisi informasi halaman kode yang relevan, tetapi ini dapat diubah untuk tujuan penyimpanan, sehingga memungkinkan satu versi diterjemahkan ke versi lain.

Jika bendera tomPasteFile tidak diatur dalam parameter Bendera , metode terlebih dahulu menutup dokumen saat ini setelah menyimpan perubahan yang belum disimpan.

File dikenali sebagai file teks Unicode jika dimulai dengan Unicode BOM 0xfeff. Metode ITextDocument::Open menghapus BOM Unicode ini pada input dan ITextDocument::Save menerapkannya pada output. Lihat komentar pada metode ITextDocument::Save , yang membahas menempatkan UNICODE BOM di awal file teks biasa Unicode. Nilai konversi tomRTF, tomHTML, dan tomWordDocument digunakan terutama untuk metode ITextDocument::Save , karena format ini mudah dikenali pada input.

Kesalahan dilaporkan oleh nilai negatif, tetapi karena operasi file memiliki banyak jenis kesalahan, Anda mungkin tidak memerlukan semua informasi kesalahan yang disediakan. Secara khusus, Anda mungkin tidak peduli (atau Anda mungkin sudah tahu) fasilitas file mana yang digunakan, yaitu penyimpanan Windows (pVar.vt = VT_BSTR) atau OLE untuk IStorage. Dengan menutupi bit 18 dari nilai HRESULT , Anda dapat mengabaikan perbedaan dan membandingkan dengan nilai STG_E_xxx . Contohnya:

HRESULT hr;
VARIANT Var;
VariantInit(&Var)

Var.vt = VT_BSTR;
Var.bstrVal = SysAllocString(L"test.txt"); // Use file command
hr = pDoc->Open(&Var, tomOpenExisting, 0);
hr &= ~0x40000; // Mask off bit 18
if(hr == STG_E_FILENOTFOUND)
{
...// the rest of the code
}

Persyaratan

Persyaratan	Nilai
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

Lihat juga

Konseptual

IStorage

IStream

ITextDocument

Sumber Daya Lain

Referensi

Simpan

Model Objek Teks

Bagikan melalui