EM_STREAMOUT zpráva

Způsobí, že ovládací prvek rich edit předat jeho obsah do aplikace definované EditStreamCallback zpětné volání funkce. Funkce zpětného volání pak může zapsat datový proud do souboru nebo do libovolného jiného umístění, které zvolí.

Parameters

wParam

Určuje formát dat a možnosti nahrazení.

Tato hodnota musí být jedna z následujících hodnot.

Value	Význam
SF_RTF	RTF.
SF_RTFNOOBJS	RTF s mezerami místo objektů COM.
SF_TEXT	Text s mezerami místo objektů MODELU COM
SF_TEXTIZED	Text s textovou reprezentací objektů MODELU COM.

Možnost SF_RTFNOOBJS je užitečná, pokud aplikace ukládá samotné objekty COM, protože reprezentace objektů COM ve formátu RTF není příliš kompaktní. Ovládací slovo \objattph následované mezerou označuje pozici objektu.

Kromě toho můžete zadat následující příznaky.

Value	Význam
SFF_PLAINRTF	Pokud je zadáno, ovládací prvek pro úpravy s formátovaným obsahem streamuje pouze klíčová slova společná pro všechny jazyky a ignoruje klíčová slova specifická pro daný jazyk. Pokud není zadaný, ovládací prvek pro úpravy s formátovaným obsahem streamuje všechna klíčová slova. Tento příznak můžete kombinovat s příznakem SF_RTF nebo SF_RTFNOOBJS .
SFF_SELECTION	Pokud je zadáno, ovládací prvek pro úpravy s formátovaným obsahem aktuálního výběru streamuje pouze obsah. Pokud není zadaný, ovládací prvek streamuje celý obsah. Tento příznak můžete kombinovat s libovolnými hodnotami formátu dat.
SF_UNICODE	Microsoft formát rtěných úprav 2.0 a novějších: Označuje text Unicode. Tento příznak můžete kombinovat s příznakem SF_TEXT , ale ne s žádnou variantou SF_RTF.
SF_USECODEPAGE	Rich Edit 3.0 a novější: Generuje UTF-8 RTF a text pomocí jiných znakových stránek. Znaková stránka je nastavena ve vysokém slově wParam. Například u UTF-8 RTF nastavte wParam na (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF. Pokud tento příznak není nastavený, vygeneruje se jakýkoli formát RTF jako 7bitový ASCII (s rozšířenými znaky ASCII s řídicími znaky).

lParam

Ukazatel na strukturu EDITSTREAM . Při vstupu musí člen pfnCallback této struktury odkazovat na aplikaci definovanou EditStreamCallback funkce. Ve výstupu může člen dwError obsahovat nenulový kód chyby, pokud došlo k chybě.

Návratová hodnota

Tato zpráva vrátí počet znaků zapsaných do datového proudu.

Remarks

Když odešlete EM_STREAMOUT zprávu, ovládací prvek rich edit provádí opakované volání EditStreamCallback funkce určené pfnCallbackčlenu EDITSTREAM struktury. Pokaždé, když volá funkci zpětného volání, ovládací prvek předává vyrovnávací paměť obsahující část obsahu ovládacího prvku. Tento proces pokračuje, dokud ovládací prvek nepředá veškerý jeho obsah funkci zpětného volání nebo dokud nedojde k chybě.

Požadavky

Requirement	Value
Minimální podporovaný klient	Windows Vista [pouze desktopové aplikace]
Minimální podporovaný server	Windows Server 2003 [pouze desktopové aplikace]
Header	Richedit.h

Viz také

Odkazy

EDITSTREAM

EditStreamCallback

EM_STREAMIN