ITextDocument::Save 方法 (tom.h)

儲存文件。

語法

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

參數

[in] pVar

類型: VARIANT*

儲存目標。 此參數是 VARIANT,可以是檔案名或 Null

[in] Flags

類型: long

檔案建立、開啟、共用和轉換旗標。 如需可能值的清單,請參閱 ITextDocument::Open

[in] CodePage

類型: long

指定的字碼頁。 常見值為 CP_ACP (零:系統 ANSI 字碼頁) 、1200 (Unicode) ,以及 1208 (UTF-8) 。

傳回值

類型: HRESULT

傳回值可以是對應至系統錯誤碼或 COM 錯誤碼的 HRESULT 值,包括下列其中一個值。

傳回碼 描述
S_OK
方法成功。
E_INVALIDARG
無效引數。
E_OUTOFMEMORY
記憶體不足。
E_NOTIMPL
未實作的功能。

備註

若要使用為開啟檔案指定的參數,請使用參數的零值。

如果 pVar 為 Null 或遺失,則會使用此檔案名稱所提供的檔案名。 如果這兩者都遺失或 Null,方法就會失敗。

如果 pVar 指定檔案名,該名稱應該取代目前的 Name 屬性。 同樣地, FlagsCodePage 引數可以覆寫 ITextDocument::Open 方法中提供的引數,並定義值,以用於以 ITextDocument::New 方法建立的檔案。

Unicode 純文字檔案應該以 Unicode 位元組順序標記 (0xFEFF) 儲存為第一個字元。 讀取檔案時,應該移除此字元;也就是說,它僅用於匯入/匯出,將純文字識別為 Unicode,並識別該文字的位元組順序。 Microsoft 記事本採用此慣例,現在由 Unicode 標準建議。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 tom.h
Dll Msftedit.dll

另請參閱

概念

ITextDocument

新增

開啟

參考

文字物件模型