messaggio di EM_STREAMOUT

Fa sì che un controllo rich edit passi il contenuto a un'applicazione definita dalla funzione di callback EditStreamCallback . La funzione di callback può quindi scrivere il flusso di dati in un file o in qualsiasi altra posizione scelta.

Parametri

wParam

Specifica il formato dei dati e le opzioni di sostituzione.

Questo valore deve essere uno dei valori seguenti.

Valore	Significato
SF_RTF	RTF.
SF_RTFNOOBJS	RTF con spazi al posto degli oggetti COM.
SF_TEXT	Testo con spazi al posto di oggetti COM.
SF_TEXTIZED	Testo con una rappresentazione testuale di oggetti COM.

L'opzione SF_RTFNOOBJS è utile se un'applicazione archivia gli oggetti COM, poiché la rappresentazione RTF degli oggetti COM non è molto compatta. La parola di controllo \objattph, seguita da uno spazio indica la posizione dell'oggetto.

Inoltre, è possibile specificare i flag seguenti.

Valore	Significato
SFF_PLAINRTF	Se specificato, il controllo rich edit esegue lo streaming solo delle parole chiave comuni a tutti i linguaggi, ignorando le parole chiave specifiche del linguaggio. Se non specificato, il controllo rich edit trasmette tutte le parole chiave. È possibile combinare questo flag con il flag SF_RTF o SF_RTFNOOBJS .
SFF_SELECTION	Se specificato, il controllo rich edit esegue lo streaming solo del contenuto della selezione corrente. Se non specificato, il controllo trasmette l'intero contenuto. È possibile combinare questo flag con uno qualsiasi dei valori di formato dati.
SF_UNICODE	Microsoft Rich Edit 2.0 e versioni successive: Indica il testo Unicode. È possibile combinare questo flag con il flag SF_TEXT .
SF_USECODEPAGE	Rich Edit 3.0 e versioni successive: Genera testo RTF E RTF UTF-8 usando altre tabelle codici. La tabella codici è impostata nella parola alta di wParam. Ad esempio, per UTF-8 RTF, impostare wParam su (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF.

lParam

Puntatore a una struttura EDITSTREAM . In input, il membro pfnCallback di questa struttura deve puntare a una funzione EditStreamCallback definita dall'applicazione. Nell'output, il membro dwError può contenere un codice di errore diverso da zero se si è verificato un errore.

Valore restituito

Questo messaggio restituisce il numero di caratteri scritti nel flusso di dati.

Commenti

Quando si invia un messaggio di EM_STREAMOUT , il controllo rich edit effettua chiamate ripetute alla funzione EditStreamCallback specificata dal membro pfnCallback della struttura EDITSTREAM . Ogni volta che chiama la funzione di callback, il controllo passa un buffer contenente una parte del contenuto del controllo. Questo processo continua fino a quando il controllo non ha passato tutto il relativo contenuto alla funzione di callback o fino a quando non si verifica un errore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Richedit.h

Vedi anche

Riferimento

EDITSTREAM

EditStreamCallback

EM_STREAMIN