pesan EM_STREAMOUT

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

Parameter

wParam

Menentukan format data dan opsi penggantian.

Nilai ini harus menjadi salah satu nilai berikut.

Nilai	Makna
SF_RTF	RTF.
SF_RTFNOOBJS	RTF dengan spasi menggantikan 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	Makna
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 akan 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 .
SF_USECODEPAGE	Kaya Edit 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.

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 bukan nol jika terjadi kesalahan.

Nilai kembali

Pesan ini mengembalikan jumlah karakter yang ditulis ke aliran data.

Keterangan

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 melewati 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

Lihat juga

Referensi

EDITSTREAM

EditStreamCallback

EM_STREAMIN