struktur CHARFORMAT2A (richedit.h)

Artikel
03/08/2023

Berisi informasi tentang pemformatan karakter dalam kontrol edit yang kaya. CHARFORMAT2 adalah ekstensi Microsoft Rich Edit 2.0 dari struktur CHARFORMAT . Microsoft Rich Edit 2.0 memungkinkan Anda menggunakan salah satu struktur dengan pesan EM_GETCHARFORMAT dan EM_SETCHARFORMAT .

Sintaks

struct CHARFORMAT2A : _charformat {
  WORD     wWeight;
  SHORT    sSpacing;
  COLORREF crBackColor;
  LCID     lcid;
  union {
    DWORD dwReserved;
    DWORD dwCookie;
  };
  DWORD    dwReserved;
  SHORT    sStyle;
  WORD     wKerning;
  BYTE     bUnderlineType;
  BYTE     bAnimation;
  BYTE     bRevAuthor;
  BYTE     bUnderlineColor;
};

Warisan

Struktur CHARFORMAT2A mengimplementasikan _charformat.

Anggota

wWeight

Ketik: WORD

Bobot font. Anggota ini sama dengan anggota lfWeight dari struktur LOGFONT . Untuk menggunakan anggota ini, atur bendera CFM_WEIGHT di anggota dwMask .

sSpacing

Jenis: PENDEK

Spasi horizontal antar huruf, dalam twips. Nilai ini tidak berpengaruh pada teks yang ditampilkan oleh kontrol edit yang kaya; ini disertakan untuk kompatibilitas dengan antarmuka WINDOWS TOM. Untuk menggunakan anggota ini, atur bendera CFM_SPACING di anggota dwMask .

crBackColor

Jenis: COLORREF

Warna latar belakang. Untuk menggunakan anggota ini, atur bendera CFM_BACKCOLOR di anggota dwMask . Anggota ini diabaikan jika efek karakter CFE_AUTOBACKCOLOR ditentukan. Untuk menghasilkan , gunakan makro.

lcid

Jenis: LCID

Pengidentifikasi lokal 32-bit yang berisi pengidentifikasi bahasa di kata yang lebih rendah dan pengidentifikasi pengurutan dan nilai yang dipesan dalam kata atas. Anggota ini tidak berpengaruh pada teks yang ditampilkan oleh kontrol edit yang kaya, tetapi pemeriksa ejaan dan tata bahasa dapat menggunakannya untuk menangani masalah yang bergantung pada bahasa. Anda dapat menggunakan makro untuk membuat nilai LCID . Untuk menggunakan anggota ini, atur bendera CFM_LCID di anggota dwMask .

dwReserved

Jenis: DWORD

Dipesan; nilainya harus nol.

dwCookie

Jenis: DWORD

Cookie klien. Anggota ini buram untuk kontrol edit yang kaya.

sStyle

Jenis: PENDEK

Gagang gaya karakter. Nilai ini tidak berpengaruh pada teks yang ditampilkan oleh kontrol edit yang kaya; ini disertakan untuk kompatibilitas dengan antarmuka WindowsTOM. Untuk menggunakan anggota ini, atur bendera CFM_STYLE di anggota dwMask . Untuk informasi selengkapnya, lihat dokumentasi TOM.

wKerning

Ketik: WORD

Nilai ukuran font, di atas untuk membuat karakter (yHeight). Nilai ini tidak berpengaruh pada teks yang ditampilkan oleh kontrol edit yang kaya; ini disertakan untuk kompatibilitas dengan antarmuka TOM. Untuk menggunakan anggota ini, atur bendera CFM_KERNING di anggota dwMask .

bUnderlineType

Jenis: BYTE

Menentukan jenis garis bawah. Untuk menggunakan anggota ini, atur bendera CFM_UNDERLINETYPE di anggota dwMask . Anggota ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
CFU_CF1UNDERLINE	Struktur memetakan garis bawah bit CHARFORMAT ke CHARFORMAT2, (artinya, ia melakukan jenis garis bawah CHARFORMAT pada teks ini).
CFU_INVERT	Untuk komposisi IME, palsukan pilihan.
CFU_UNDERLINE	Teks digaris bawahi dengan satu garis solid.
CFU_UNDERLINEDASH	Teks digaris bawahi dengan tanda hubung.
CFU_UNDERLINEDASHDOT	Teks digarisbawahi dengan garis putus-putus dan putus-putus.
CFU_UNDERLINEDASHDOTDOT	Teks digarisbawahi dengan garis putus-putus dan titik-titik ganda.
CFU_UNDERLINEDOTTED	Teks digarisbawahi dengan garis putus-putus. Untuk versi yang lebih lama dari Microsoft Rich Edit 3.0, teks ditampilkan dengan garis bawah solid.
CFU_UNDERLINEDOUBLE	Teks digaris bawahi dengan garis ganda. Kontrol edit kaya menampilkan teks dengan garis bawah solid.
CFU_UNDERLINEDOUBLEWAVE	Tampilkan sebagai CFU_UNDERLINEWAVE.
CFU_UNDERLINEHAIRLINE	Tampilkan sebagai CFU_UNDERLINE.
CFU_UNDERLINEHEAVYWAVE	Tampilkan sebagai CFU_UNDERLINEWAVE.
CFU_UNDERLINELONGDASH	Tampilkan sebagai CFU_UNDERLINEDASH.
CFU_UNDERLINENONE	Tidak ada garis bawah. Ini adalah default.
CFU_UNDERLINETHICK	Tampilkan sebagai CFU_UNDERLINE.
CFU_UNDERLINETHICKDASH	Tampilkan sebagai CFU_UNDERLINEDASH.
CFU_UNDERLINETHICKDASHDOT	Tampilkan sebagai CFU_UNDERLINEDASHDOT.
CFU_UNDERLINETHICKDASHDOTDOT	Tampilkan sebagai CFU_UNDERLINEDASHDOT.
CFU_UNDERLINETHICKDOTTED	Tampilkan sebagai CFU_UNDERLINEDOT.
CFU_UNDERLINETHICKLONGDASH	Tampilkan sebagai CFU_UNDERLINEDASH.
CFU_UNDERLINEWAVE	RichEdit 4.1 dan yang lebih baru: Teks digaris bawahi dengan garis bergelombang.
CFU_UNDERLINEWORD	RichEdit 4.1 dan yang lebih baru: Kata garis bawah saja. Kontrol edit kaya menampilkan teks dengan garis bawah solid.

bAnimation

Jenis: BYTE

Tipe animasi teks. Nilai ini tidak berpengaruh pada teks yang ditampilkan oleh kontrol edit yang kaya; ini disertakan untuk kompatibilitas dengan antarmuka TOM. Untuk menggunakan anggota ini, atur bendera CFM_ANIMATION di anggota dwMask .

bRevAuthor

Jenis: BYTE

Indeks yang mengidentifikasi penulis membuat revisi. Kontrol edit yang kaya menggunakan warna teks yang berbeda untuk setiap indeks penulis yang berbeda. Untuk menggunakan anggota ini, atur bendera CFM_REVAUTHOR di anggota dwMask .

bUnderlineColor

Jenis: BYTE

Warna garis bawah:

UnderlineColor_Black = 0x00;
UnderlineColor_Blue = 0x01;
UnderlineColor_Aqua = 0x02;
UnderlineColor_Lime = 0x03;
UnderlineColor_Fuchsia = 0x04;
UnderlineColor_Red = 0x05;
UnderlineColor_Yellow = 0x06;
UnderlineColor_White = 0x07;
UnderlineColor_Navy = 0x08;
UnderlineColor_Teal = 0x09;
UnderlineColor_Green = 0x0A;
UnderlineColor_Purple = 0x0B;
UnderlineColor_Maroon = 0x0C;
UnderlineColor_Olive = 0x0D;
UnderlineColor_DkGray = 0x0E;
UnderlineColor_LtGray = 0x0F;

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