_Message STREAMOUT em

Fait en sorte qu’un contrôle RichEdit passe 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 qu’il choisit.

Paramètres

wParam

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

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

Valeur Signification
_RTF SF
RTF.
_RTFNOOBJS DF
RTF avec espaces à la place des objets COM.
_texte SF
Texte avec des espaces à la place des objets COM.
SF _ texte
Texte avec une représentation textuelle des objets COM.

L’option DF _ 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 Signification
_PLAINRTF SFF
S’il est spécifié, le contrôle RichEdit diffuse uniquement les mots clés communs à tous les langages, en ignorant les mots clés spécifiques à une langue. S’il n’est pas spécifié, le contrôle RichEdit diffuse tous les mots clés. Vous pouvez combiner cet indicateur avec l’indicateur DF _ RTF ou DF _ RTFNOOBJS .
_sélection SFF
S’il est spécifié, le contrôle RichEdit diffuse uniquement le contenu de la sélection actuelle. S’il n’est pas spécifié, le contrôle diffuse en continu le contenu entier. Vous pouvez combiner cet indicateur avec l’une des valeurs de format de données.
_Unicode DF
Microsoft Rich Edit 2,0 et versions ultérieures : Indique un texte Unicode. Vous pouvez combiner cet indicateur avec l’indicateur de _ texte DF .
DF _ USECODEPAGE
Édition enrichie 3,0 et versions ultérieures : Génère le format RTF UTF-8 ainsi que du texte à l’aide d’autres pages de codes. La page de codes est définie dans le mot de wParam. Par exemple, pour le format RTF UTF-8, affectez à wParam la valeur (CP _ UTF8 << 16) | SF _ USECODEPAGE | DF _ 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. En sortie, le membre dwError peut contenir un code d’erreur différent de zéro si une erreur s’est produite.

Valeur de retour

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 RichEdit 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 [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
En-tête
RichEdit. h

Voir aussi

Référence

EDITSTREAM

EditStreamCallback

_flux em