Struktur CHARFORMATA (richedit.h)

Artikel
08/15/2024

Berisi informasi tentang pemformatan karakter dalam kontrol edit yang kaya.

Rich 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.

Sintaksis

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 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	Arti
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	Arti
CFE_AUTOCOLOR	Warna teks adalah nilai pengembalianGetSysColor (COLOR_WINDOWTEXT).
CFE_BOLD	Karakter tebal.
CFE_DISABLED	RichEdit 2.0 dan yang lebih baru: Karakter ditampilkan dengan bayangan yang diimbangi dengan 3/4 poin 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 twips (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 menghasilkanCOLORREF , gunakan makro RGB .

bCharSet

Jenis: BYTE

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

bPitchAndFamily

Jenis: BYTE

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

szFaceName[LF_FACESIZE]

Jenis: TCHAR[LF_FACESIZE]

Array karakter null-terminated yang menentukan nama font.

Komentar

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.

Nota

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

Syarat	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

Bagikan melalui