EM_STREAMOUT message

Provoque la transmission d’un contrôle d’édition enrichi à une fonction de rappel EditStreamCallback définie par l’application. La fonction de rappel peut ensuite écrire le flux de données dans un fichier ou tout autre emplacement de son choix.

Paramètres

wParam

Spécifie le format des données et les options de remplacement.

Cette valeur doit être l’une des valeurs suivantes.

Valeur	Signification
SF_RTF	RTF.
SF_RTFNOOBJS	RTF avec des espaces à la place d’objets COM.
SF_TEXT	Texte avec des espaces à la place d’objets COM.
SF_TEXTIZED	Texte avec une représentation textuelle d’objets COM.

L’option SF_RTFNOOBJS est utile si une application stocke des objets COM elle-même, car la représentation RTF des objets COM n’est pas très compacte. Le mot de contrôle, \objattph, suivi d’un espace indique la position de l’objet.

En outre, vous pouvez spécifier les indicateurs suivants.

Valeur	Signification
SFF_PLAINRTF	S’il est spécifié, le contrôle d’édition enrichi diffuse uniquement les mots clés communs à toutes les langues, en ignorant les mots clés spécifiques à la langue. S’il n’est pas spécifié, le contrôle d’édition enrichi diffuse tous les mots clés. Vous pouvez combiner cet indicateur avec l’indicateur SF_RTF ou SF_RTFNOOBJS .
SFF_SELECTION	S’il est spécifié, le contrôle d’édition enrichi diffuse uniquement le contenu de la sélection actuelle. S’il n’est pas spécifié, le contrôle diffuse l’intégralité du contenu. Vous pouvez combiner cet indicateur avec n’importe quelle valeur de format de données.
SF_UNICODE	Microsoft Rich Edit 2.0 et versions ultérieures : Indique le texte Unicode. Vous pouvez combiner cet indicateur avec l’indicateur SF_TEXT .
SF_USECODEPAGE	Rich Edit 3.0 et versions ultérieures : Génère UTF-8 RTF et du texte à l’aide d’autres pages de code. La page de code est définie dans le mot en haut de wParam. Par exemple, pour UTF-8 RTF, définissez wParam sur (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF.

lParam

Pointeur vers une structure EDITSTREAM . En entrée, le membre pfnCallback de cette structure doit pointer vers une fonction EditStreamCallback définie par l’application . Lors de la sortie, le membre dwError peut contenir un code d’erreur différent de zéro si une erreur s’est produite.

Valeur retournée

Ce message retourne le nombre de caractères écrits dans le flux de données.

Notes

Lorsque vous envoyez un message EM_STREAMOUT , le contrôle d’édition enrichi effectue des appels répétés à la fonction EditStreamCallback spécifiée par le membre pfnCallback de la structure EDITSTREAM . Chaque fois qu’il appelle la fonction de rappel, le contrôle passe une mémoire tampon contenant une partie du contenu du contrôle. Ce processus se poursuit jusqu’à ce que le contrôle ait passé tout son contenu à la fonction de rappel, ou jusqu’à ce qu’une erreur se produise.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Richedit.h

Voir aussi

Référence

EDITSTREAM

EditStreamCallback

EM_STREAMIN