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 |
|
Vedi anche
-
Riferimento