message EM_STREAMOUT

Provoque un contrôle d’édition enrichi pour transmettre son contenu à 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 choisi.

Parameters

wParam

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

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

Valeur	Sens
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 lui-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	Sens
SFF_PLAINRTF	Si spécifié, le contrôle d’édition enrichi diffuse uniquement les mots clés communs à tous les langages, 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 , mais pas avec une variante de SF_RTF.
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 codes. La page de codes est définie dans le mot élevé de wParam. Par exemple, pour UTF-8 RTF, définissez wParam sur (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF. Si cet indicateur n’est pas défini, une valeur RTF est générée en tant qu’ASCII 7 bits (avec des caractères ASCII étendus échappés).

lParam

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

Valeur renvoyée

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

Remarks

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 transmet une mémoire tampon contenant une partie du contenu du contrôle. Ce processus se poursuit jusqu’à ce que le contrôle ait transmis tout son contenu à la fonction de rappel, ou jusqu’à ce qu’une erreur se produise.

Exigences

Requirement	Valeur
Client minimum requis	Windows Vista [applications de bureau uniquement]
Serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
Header	Richedit.h

Voir aussi

Référence

EDITSTREAM

EditStreamCallback

EM_STREAMIN