使富编辑控件将其内容传递给应用程序定义的 EditStreamCallback 回调函数。 然后,回调函数可以将数据流写入文件或其选择的任何其他位置。
Parameters
-
wParam
-
指定数据格式和替换选项。
此值必须是以下值之一。
价值 Meaning - SF_RTF
RTF。 - SF_RTFNOOBJS
包含空格代替 COM 对象的 RTF。 - SF_TEXT
包含空格的文本代替 COM 对象。 - SF_TEXTIZED
具有 COM 对象的文本表示形式的文本。 如果应用程序存储 COM 对象本身, 则SF_RTFNOOBJS 选项非常有用,因为 COM 对象的 RTF 表示形式并不非常紧凑。 控件单词 \objattph,后跟空格表示对象位置。
此外,还可以指定以下标志。
价值 Meaning - SFF_PLAINRTF
如果指定,则富编辑控件仅流出所有语言通用的关键字,忽略特定于语言的关键字。 如果未指定,则富编辑控件会流出所有关键字。 可以将此标志与 SF_RTF 或SF_RTFNOOBJS标志组合在 一 起。 - SFF_SELECTION
如果指定,则富编辑控件仅流出当前所选内容。 如果未指定,控件会流出整个内容。 可以将此标志与任何数据格式值组合在一起。 - SF_UNICODE
Microsoft Rich Edit 2.0 及更高版本:指示 Unicode 文本。 可以将此标志与 SF_TEXT 标志合并,但不能与 SF_RTF的任何变体结合使用。 - SF_USECODEPAGE
Rich Edit 3.0 及更高版本: 使用其他代码页生成 UTF-8 RTF 和文本。 代码页是在 wParam 的高字中设置的。 例如,对于 UTF-8 RTF,请将 wParam 设置为 (CP_UTF8 << 16) |SF_USECODEPAGE |SF_RTF。 如果未设置此标志,则任何 RTF 都将生成为 7 位 ASCII(已转义扩展 ASCII 字符)。 -
lParam
-
指向 EDITSTREAM 结构的指针。 在输入时,此结构的 pfnCallback 成员必须指向应用程序定义的 EditStreamCallback 函数。 输出时, dwError 成员可以包含非零错误代码(如果发生错误)。
返回值
此消息返回写入数据流的字符数。
Remarks
发送EM_STREAMOUT消息时,富编辑控件对 EDITSTREAM 结构的 pfnCallback 成员指定的 EditStreamCallback 函数进行重复调用。 每次调用回调函数时,控件都会传递包含控件内容的一部分的缓冲区。 此过程一直持续到控件已将其所有内容传递到回调函数,或直到发生错误为止。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 |
Windows Vista [仅限桌面应用] |
| 支持的最低服务器 |
Windows Server 2003 [仅限桌面应用] |
| Header |
|