EM_STREAMOUT bericht

Zorgt ervoor dat een uitgebreid besturingselement voor bewerken de inhoud ervan doorgeeft aan een door de toepassing gedefinieerde editStreamCallback-callback-functie . De callback-functie kan vervolgens de gegevensstroom naar een bestand of een andere locatie schrijven die door de functie wordt gekozen.

Parameters

wParam

Hiermee geeft u de gegevensindeling en vervangingsopties.

Deze waarde moet een van de volgende waarden zijn.

Value Meaning
SF_RTF
RTF.
SF_RTFNOOBJS
RTF met spaties in plaats van COM-objecten.
SF_TEXT
Tekst met spaties in plaats van COM-objecten.
SF_TEXTIZED
Tekst met een tekstweergave van COM-objecten.

De SF_RTFNOOBJS optie is handig als een toepassing COM-objecten zelf opslaat, omdat RTF-weergave van COM-objecten niet erg compact is. Het besturingselementwoord \objattph, gevolgd door een spatie geeft de objectpositie aan.

Daarnaast kunt u de volgende vlaggen opgeven.

Value Meaning
SFF_PLAINRTF
Indien opgegeven, streamt het uitgebreide besturingselement voor bewerken alleen de trefwoorden die voor alle talen worden gebruikt, waarbij taalspecifieke trefwoorden worden genegeerd. Als dit niet is opgegeven, worden alle trefwoorden door het uitgebreide besturingselement bewerkt. U kunt deze vlag combineren met de vlag SF_RTF of SF_RTFNOOBJS .
SFF_SELECTION
Als dit is opgegeven, wordt alleen de inhoud van de huidige selectie uitgestreamd met het besturingselement voor uitgebreide bewerkingen. Als dit niet is opgegeven, wordt de volledige inhoud door het besturingselement gestreamd. U kunt deze vlag combineren met waarden voor gegevensindeling.
SF_UNICODE
Microsoft Rich Edit 2.0 en hoger: Geeft Unicode-tekst aan. U kunt deze vlag combineren met de SF_TEXT vlag, maar niet met een variatie van SF_RTF.
SF_USECODEPAGE
Rich Edit 3.0 en hoger: Genereert UTF-8 RTF en tekst met behulp van andere codepagina's. De codepagina wordt ingesteld in het hoge woord wParam. Stel bijvoorbeeld voor UTF-8 RTF wParam in op (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF. Als deze vlag niet is ingesteld, wordt een RTF gegenereerd als 7-bits ASCII (waarbij uitgebreide ASCII-tekens zijn ontsnapt).

lParam

Aanwijzer naar een EDITSTREAM-structuur . Bij invoer moet het pfnCallback-lid van deze structuur verwijzen naar een door de toepassing gedefinieerde EditStreamCallback-functie . In de uitvoer kan het dwError-lid een niet-zero-foutcode bevatten als er een fout is opgetreden.

Retourwaarde

Dit bericht retourneert het aantal tekens dat naar de gegevensstroom is geschreven.

Remarks

Wanneer u een EM_STREAMOUT bericht verzendt, worden herhaalde aanroepen uitgevoerd naar de functie EditStreamCallback die is opgegeven door het lid pfnCallback van de EDITSTREAM-structuur . Telkens wanneer de callback-functie wordt aangeroepen, geeft het besturingselement een buffer door die een deel van de inhoud van het besturingselement bevat. Dit proces wordt voortgezet totdat het besturingselement alle inhoud heeft doorgegeven aan de callback-functie of totdat er een fout optreedt.

Requirements

Requirement Value
Minimaal ondersteunde client
Windows Vista [alleen desktop-apps]
Minimaal ondersteunde server
Windows Server 2003 [alleen desktop-apps]
Koptekst
Richedit.h

Zie ook

Referentie

EDITSTREAM

EditStreamCallback

EM_STREAMIN