pesan EM_STREAMOUT

Menyebabkan kontrol edit yang kaya untuk meneruskan kontennya ke aplikasi yang ditentukan fungsi panggilan balik EditStreamCallback . Fungsi panggilan balik kemudian dapat menulis aliran data ke file atau lokasi lain yang dipilihnya.

Parameters

wParam

Menentukan format data dan opsi penggantian.

Nilai ini harus menjadi salah satu nilai berikut.

Nilai	Meaning
SF_RTF	RTF.
SF_RTFNOOBJS	RTF dengan spasi sebagai pengganti objek COM.
SF_TEXT	Teks dengan spasi sebagai pengganti objek COM.
SF_TEXTIZED	Teks dengan representasi teks objek COM.

Opsi SF_RTFNOOBJS berguna jika aplikasi menyimpan objek COM itu sendiri, karena representasi RTF objek COM tidak terlalu ringkas. Kata kontrol, \objattph, diikuti dengan spasi menunjukkan posisi objek.

Selain itu, Anda dapat menentukan bendera berikut.

Nilai	Meaning
SFF_PLAINRTF	Jika ditentukan, kontrol edit kaya hanya mengalirkan kata kunci yang umum untuk semua bahasa, mengabaikan kata kunci khusus bahasa. Jika tidak ditentukan, kontrol edit kaya mengalirkan semua kata kunci. Anda dapat menggabungkan bendera ini dengan bendera SF_RTF atau SF_RTFNOOBJS .
SFF_SELECTION	Jika ditentukan, kontrol edit kaya hanya mengalirkan konten pilihan saat ini. Jika tidak ditentukan, kontrol mengalirkan seluruh konten. Anda dapat menggabungkan bendera ini dengan salah satu nilai format data.
SF_UNICODE	Microsoft Rich Edit 2.0 dan yang lebih baru: Menunjukkan teks Unicode. Anda dapat menggabungkan bendera ini dengan bendera SF_TEXT , tetapi tidak dengan variasi SF_RTF apa pun.
SF_USECODEPAGE	Edit Kaya 3.0 dan yang lebih baru: Menghasilkan UTF-8 RTF dan teks menggunakan halaman kode lainnya. Halaman kode diatur dalam kata tinggi wParam. Misalnya, untuk UTF-8 RTF, atur wParam ke (CP_UTF8 << 16) | SF_USECODEPAGE | SF_RTF. Jika bendera ini tidak diatur, maka RTF apa pun akan dihasilkan sebagai ASCII 7-bit (dengan karakter ASCII yang diperluas lolos).

lParam

Penunjuk ke struktur EDITSTREAM . Pada input, anggota pfnCallback dari struktur ini harus menunjuk ke aplikasi yang ditentukan fungsi EditStreamCallback . Pada output, anggota dwError dapat berisi kode kesalahan nonzero jika terjadi kesalahan.

Mengembalikan nilai

Pesan ini mengembalikan jumlah karakter yang ditulis ke aliran data.

Remarks

Saat Anda mengirim pesan EM_STREAMOUT , kontrol edit kaya melakukan panggilan berulang ke fungsi EditStreamCallback yang ditentukan oleh anggota pfnCallback dari struktur EDITSTREAM . Setiap kali memanggil fungsi panggilan balik, kontrol meneruskan buffer yang berisi sebagian konten kontrol. Proses ini berlanjut hingga kontrol meneruskan semua kontennya ke fungsi panggilan balik, atau sampai terjadi kesalahan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Richedit.h

Baca juga

Referensi

EDITSTREAM

EditStreamCallback

EM_STREAMIN