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

指定的代码页。 常见值为 0 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

新建

打开

引用

文本对象模型