EM_STREAMIN消息

将 Rich Edit 控件的内容替换为由应用程序定义的 EditStreamCallback 回调函数提供的数据流。

参数

wParam

指定数据格式和替换选项。 此值必须是下列值之一。

值	含义
SF_RTF	RTF
SF_TEXT	文本

此外，还可以指定以下标志。

值	含义
SFF_PLAINRTF	如果指定，则仅流式传输所有语言通用的关键字。 流中特定于语言的 RTF 关键字将被忽略。 如果未指定，则流式传输所有关键字。 可以将此标志与 SF_RTF 标志组合在一起。
SFF_SELECTION	如果指定，数据流将替换当前所选内容。 如果未指定，数据流将替换控件的整个内容。 可以将此标志与 SF_TEXT 或 SF_RTF 标志组合使用。
SF_UNICODE	Microsoft Rich Edit 2.0 及更高版本： 指示 Unicode 文本。 可以将此标志与 SF_TEXT 标志组合在一起。
SF_USECODEPAGE	Rich Edit 3.0 及更高版本： 使用其他代码页读取 UTF-8 RTF 和文本。 代码页在 wParam 的高字中设置。 例如，对于 UTF-8 RTF，请将 wParam 设置为 (CP_UTF8 << 16) |SF_USECODEPAGE |SF_RTF。

lParam

指向 EDITSTREAM 结构的指针。 输入时，此结构的 pfnCallback 成员必须指向应用程序定义的 EditStreamCallback 函数。 在输出中，如果发生错误， dwError 成员可以包含非零错误代码。

返回值

此消息返回读取的字符数。

注解

发送EM_STREAMIN消息时，Rich Edit 控件会重复调用 EDITSTREAM 结构的 pfnCallback 成员指定的 EditStreamCallback 函数。 每次调用回调函数时，它都会用要读入控件的数据填充缓冲区。 此操作会一直持续到回调函数指示流传入操作已完成或发生错误为止。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	Richedit.h

另请参阅

引用

EDITSTREAM

EditStreamCallback

EM_STREAMOUT