mensaje de EM_STREAMOUT

Hace que un control de edición enriquecido pase su contenido a una aplicación definida por la función de devolución de llamada EditStreamCallback . Después, la función de devolución de llamada puede escribir el flujo de datos en un archivo o en cualquier otra ubicación que elija.

Parámetros

wParam

Especifica el formato de datos y las opciones de reemplazo.

Este valor debe ser uno de los siguientes valores.

Valor	Significado
SF_RTF	RTF.
SF_RTFNOOBJS	RTF con espacios en lugar de objetos COM.
SF_TEXT	Texto con espacios en lugar de objetos COM.
SF_TEXTIZED	Texto con una representación de texto de objetos COM.

La opción SF_RTFNOOBJS es útil si una aplicación almacena objetos COM en sí, ya que la representación RTF de objetos COM no es muy compacta. La palabra de control \objattph, seguida de un espacio denota la posición del objeto.

Además, puede especificar las marcas siguientes.

Valor	Significado
SFF_PLAINRTF	Si se especifica, el control de edición enriquecido transmite solo las palabras clave comunes a todos los lenguajes, ignorando las palabras clave específicas del lenguaje. Si no se especifica, el control de edición enriquecido transmite todas las palabras clave. Puede combinar esta marca con la marca SF_RTF o SF_RTFNOOBJS .
SFF_SELECTION	Si se especifica, el control de edición enriquecido transmite solo el contenido de la selección actual. Si no se especifica, el control transmite todo el contenido. Puede combinar esta marca con cualquiera de los valores de formato de datos.
SF_UNICODE	Microsoft Rich Edit 2.0 y versiones posteriores: Indica texto Unicode. Puede combinar esta marca con la marca SF_TEXT .
SF_USECODEPAGE	Rich Edit 3.0 y versiones posteriores: Genera UTF-8 RTF y texto con otras páginas de códigos. La página de códigos se establece en la palabra alta de wParam. Por ejemplo, para UTF-8 RTF, establezca wParam en (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF.

lParam

Puntero a una estructura EDITSTREAM . En la entrada, el miembro pfnCallback de esta estructura debe apuntar a una función EditStreamCallback definida por la aplicación. En la salida, el miembro dwError puede contener un código de error distinto de cero si se produjo un error.

Valor devuelto

Este mensaje devuelve el número de caracteres escritos en el flujo de datos.

Comentarios

Al enviar un mensaje de EM_STREAMOUT , el control de edición enriquecido realiza llamadas repetidas a la función EditStreamCallback especificada por el miembro pfnCallback de la estructura EDITSTREAM . Cada vez que llama a la función de devolución de llamada, el control pasa un búfer que contiene una parte del contenido del control. Este proceso continúa hasta que el control haya pasado todo su contenido a la función de devolución de llamada o hasta que se produzca un error.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Richedit.h

Consulte también

Referencia

EDITSTREAM

EditStreamCallback

EM_STREAMIN