Struktur CHARFORMATA (richedit.h)

Artikel
03/04/2024

Berisi informasi tentang pemformatan karakter dalam kontrol edit yang kaya.

Kaya Edit 2.0: Struktur CHARFORMAT2 adalah ekstensi Microsoft Rich Edit 2.0 dari struktur CHARFORMAT . Microsoft Rich Edit 2.0 dan yang lebih baru memungkinkan Anda menggunakan salah satu struktur dengan pesan EM_GETCHARFORMAT dan EM_SETCHARFORMAT .

Sintaks

typedef struct _charformat {
  UINT     cbSize;
  DWORD    dwMask;
  DWORD    dwEffects;
  LONG     yHeight;
  LONG     yOffset;
  COLORREF crTextColor;
  BYTE     bCharSet;
  BYTE     bPitchAndFamily;
  char     szFaceName[LF_FACESIZE];
} CHARFORMATA;

Anggota

cbSize

Jenis: UINT

Ukuran dalam byte dari struktur yang ditentukan. Anggota ini harus diatur sebelum meneruskan struktur ke kontrol edit yang kaya.

dwMask

Jenis: DWORD

Anggota yang berisi informasi atau atribut yang valid untuk diatur. Anggota ini bisa nol, satu, atau lebih dari salah satu nilai berikut.

Nilai	Makna
CFM_ALL	Windows 8: Kombinasi nilai berikut: CFM_EFFECTS \| CFM_SIZE \| CFM_FACE \| CFM_OFFSET \| CFM_CHARSET
CFM_BOLD	Nilai CFE_BOLD anggota dwEffects valid.
CFM_CHARSET	Anggota bCharSet valid.
CFM_COLOR	Anggota crTextColor dan nilai CFE_AUTOCOLOR anggota dwEffects valid.
CFM_EFFECTS	Windows 8: Kombinasi nilai berikut: CFM_BOLD \| CFM_ITALIC \| CFM_UNDERLINE \| CFM_COLOR \| CFM_STRIKEOUT \| CFE_PROTECTED \| CFM_LINK
CFM_FACE	Anggota szFaceName valid.
CFM_ITALIC	Nilai CFE_ITALIC anggota dwEffects valid.
CFM_OFFSET	Anggota yOffset valid.
CFM_PROTECTED	Nilai CFE_PROTECTED anggota dwEffects valid.
CFM_SIZE	Anggota yHeight valid.
CFM_STRIKEOUT	Nilai CFE_STRIKEOUT anggota dwEffects valid.
CFM_UNDERLINE.	Nilai CFE_UNDERLINE anggota dwEffects valid.

dwEffects

Jenis: DWORD

Efek karakter. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
CFE_AUTOCOLOR	Warna teks adalah nilai pengembalian GetSysColor(COLOR_WINDOWTEXT).
CFE_BOLD	Karakter tebal.
CFE_DISABLED	RichEdit 2.0 dan yang lebih baru: Karakter ditampilkan dengan bayangan yang diimbangi oleh 3/4 titik atau satu piksel, mana yang lebih besar.
CFE_ITALIC	Karakter miring.
CFE_STRIKEOUT	Karakter disambar.
CFE_UNDERLINE	Karakter digaris bawahi.
CFE_PROTECTED	Karakter dilindungi; upaya untuk mengubahnya akan menyebabkan kode pemberitahuan EN_PROTECTED .

yHeight

Jenis: LONG

Tinggi karakter, dalam ranjau (1/1440 inci atau 1/20 dari titik printer).

yOffset

Jenis: LONG

Offset karakter, dalam twips, dari garis besar. Jika nilai anggota ini positif, karakternya adalah superskrip; jika negatif, karakternya adalah subskrip.

crTextColor

Jenis: COLORREF

Warna teks. Anggota ini diabaikan jika efek karakter CFE_AUTOCOLOR ditentukan. Untuk menghasilkan COLORREF, gunakan makro RGB .

bCharSet

Jenis: BYTE

Nilai set karakter. Anggota bCharSet dapat menjadi salah satu nilai yang ditentukan untuk anggota lfCharSet dari struktur LOGFONT . Microsoft Rich Edit 3.0 dapat menggantikan nilai ini jika tidak valid untuk karakter target.

bPitchAndFamily

Jenis: BYTE

Keluarga font dan nada. Anggota ini sama dengan anggota lfPitchAndFamily dari struktur LOGFONT .

szFaceName[LF_FACESIZE]

Jenis: TCHAR[LF_FACESIZE]

Array karakter yang dihentikan null yang menentukan nama font.

Keterangan

Untuk menonaktifkan atribut pemformatan, atur nilai yang sesuai di dwMask tetapi jangan atur nilai yang sesuai di dwEffects. Misalnya, untuk menonaktifkan miring, atur CFM_ITALIC tetapi jangan atur CFE_ITALIC.

Catatan

Header richedit.h mendefinisikan CHARFORMAT sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

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