struktur CHARFORMAT2W (richedit.h)

Artikel
08/15/2024

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.

Sintaksis

struct CHARFORMAT2W : _charformatw {
  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 CHARFORMAT2W mengimplementasikan _charformatw.

Anggota

wWeight

Jenis: WORD

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

sSpacing

Jenis: SHORT

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 dwMask anggota.

dwReserved

Jenis: DWORD

Dipesan; nilainya harus nol.

Jenis: DWORD

Dipesan; nilainya harus nol.

dwCookie

Jenis: DWORD

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

sStyle

Jenis: SHORT

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

Jenis: WORD

Nilai ukuran font, di atasnya untuk membuat kern 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	Arti
CFU_CF1UNDERLINE	Peta struktur bit CHARFORMATgaris bawah untuk 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 putus-putus 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 yang solid.
CFU_UNDERLINEDOUBLE	Teks digaris bawahi dengan garis ganda. Kontrol edit kaya menampilkan teks dengan garis bawah yang 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 digarisbawaahkan dengan garis bergelombang.
CFU_UNDERLINEWORD	RichEdit 4.1 dan yang lebih baru: Garis bawahi kata saja. Kontrol edit kaya menampilkan teks dengan garis bawah yang solid.

bAnimation

Jenis: BYTE

Jenis 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 yang membuat revisi. Kontrol edit 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;

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 CHARFORMAT2 sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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