EM_SETCHARFORMAT pesan

Mengatur pemformatan karakter dalam kontrol edit yang kaya.

Parameter

wParam

Pemformatan karakter yang berlaku untuk kontrol. Jika parameter ini nol, format karakter default diatur. Jika tidak, itu bisa menjadi salah satu nilai berikut.

Nilai Makna
SCF_ALL
Menerapkan pemformatan ke semua teks dalam kontrol. Tidak valid dengan SCF_SELECTION atau SCF_WORD.
SCF_ASSOCIATEFONT
RichEdit 4.1: Mengaitkan font ke skrip tertentu, sehingga mengubah font default untuk skrip tersebut. Untuk menentukan font, gunakan anggota CHARFORMAT2 berikut: yHeight, bCharSet, bPitchAndFamily, szFaceName, dan lcid.
SCF_ASSOCIATEFONT2
RichEdit 4.1: Mengaitkan font pengganti (plane-2) ke skrip tertentu, sehingga mengubah font default untuk skrip tersebut. Untuk menentukan font, gunakan anggota CHARFORMAT2 berikut: yHeight, bCharSet, bPitchAndFamily, szFaceName, dan lcid.
SCF_CHARREPFROMLCID
Mendapatkan repertoar karakter dari LCID.
SCF_DEFAULT
RichEdit 4.1: Mengatur font default untuk kontrol.
SPF_DONTSETDEFAULT
Mencegah pengaturan format paragraf default saat kontrol edit kaya kosong.
SCF_NOKBUPDATE
RichEdit 4.1: Mencegah peralihan papan tombol agar sesuai dengan font. Misalnya, jika font Arab diatur, biasanya fitur keyboard otomatis untuk bahasa Bidi mengubah keyboard menjadi keyboard Arab.
SCF_SELECTION
Menerapkan pemformatan ke pilihan saat ini. Jika pilihan kosong, pemformatan karakter diterapkan ke titik penyisipan, dan format karakter baru hanya berlaku sampai titik penyisipan berubah.
SPF_SETDEFAULT
Mengatur atribut pemformatan paragraf default.
SCF_SMARTFONT
Terapkan font hanya jika dapat menangani skrip.
SCF_USEUIRULES
RichEdit 4.1: Digunakan dengan SCF_SELECTION. Menunjukkan bahwa format berasal dari toolbar atau alat UI lainnya, sehingga aturan pemformatan UI harus digunakan alih-alih pemformatan harfiah.
SCF_WORD
Menerapkan pemformatan ke kata atau kata terpilih. Jika pilihan kosong tetapi titik penyisipan berada di dalam kata, pemformatan diterapkan ke kata. Nilai SCF_WORD harus digunakan bersama dengan nilai SCF_SELECTION .

lParam

Penunjuk ke struktur CHARFORMAT yang menentukan pemformatan karakter yang akan digunakan. Hanya atribut pemformatan yang ditentukan oleh anggota dwMask yang diubah.

Microsoft Rich Edit 2.0 dan yang lebih baru: Parameter ini dapat menjadi penunjuk ke struktur CHARFORMAT2 , yang merupakan ekstensi dari struktur CHARFORMAT . Sebelum mengirim pesan EM_SETCHARFORMAT , atur anggota cbSize struktur ke sizeof(CHARFORMAT) atau sizeof(CHARFORMAT2) tunjukkan versi struktur mana yang sedang digunakan.

Anggota szFaceName dan bCharSet dapat ditimpa ketika tidak valid untuk karakter, misalnya: Arial pada karakter kanji.

Nilai kembali

Jika operasi berhasil, nilai yang dikembalikan adalah nilai bukan nol.

Jika operasi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Jika pesan ini dikirim lebih dari sekali dengan parameter yang sama, efek pada teks akan beralih. Artinya, mengirim pesan setelah menghasilkan efek, mengirim pesan dua kali membatalkan efek, dan sebagainya.

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

CHARFORMAT

CHARFORMAT2