CHARFORMAT2

[นี่คือเอกสารเบื้องต้นและเรื่องการเปลี่ยนแปลง]

CHARFORMAT2โครงสร้างประกอบด้วยข้อมูลเกี่ยวกับการจัดรูปแบบในตัวควบคุม rich แก้ไขอักขระ CHARFORMAT2เป็นส่วนขยายรวยแก้ไข 2.0 ของโครงสร้างCHARFORMAT รวยแก้ไข 2.0 ช่วยให้คุณสามารถใช้โครงสร้างใดกับข้อความEM_GETCHARFORMATและEM_SETCHARFORMAT.

typedef struct _charformat2 {
    UINT cbSize
    _WPAD _wPad1
    DWORD dwMask
    DWORD dwEffects
    LONG yHeight
    LONG yOffset
    COLORREF crTextColor
    ไบต์ bCharSet
    ไบต์ bPitchAndFamily
    WCHAR szFaceName [LF_FACESIZE];
    _WPAD _wPad2
    WORD wWeight
    SSpacing ย่อ
    COLORREF crBackColor
    LCID lcid
    DWORD dwReserved
    SStyle ย่อ
    WORD wKerning
    ไบต์ bUnderlineType
    ไบต์ bAnimation
    ไบต์ bRevAuthor
    ไบต์ bReserved1
} CHARFORMAT2

สมาชิก

cbSize

ระบุขนาด ในไบต์ โครงสร้างนี้ ก่อนที่จะผ่านโครงสร้างนี้กับตัวควบคุมการแก้ไขที่รวย ตั้งค่าcbSizeขนาดของโครงสร้างCHARFORMATหรือCHARFORMAT2 ถ้าcbSizeเท่ากับขนาดของโครงสร้างCHARFORMATควบคุมการใช้เฉพาะสมาชิกCHARFORMAT.

dwMask

ระบุส่วนของโครงสร้างของCHARFORMAT2ที่ประกอบด้วยข้อมูลที่ถูกต้อง สมาชิกdwMaskอาจเป็นการรวมกันของค่าจากสองชุดของค่าสถานะบิต ชุดหนึ่งระบุว่า สมาชิกของโครงสร้างที่ไม่ถูกต้อง แอตทริบิวต์ที่ถูกต้องในสมาชิกdwEffectsที่บ่งชี้ว่า ชุดอื่น.

ตั้งค่าต่อไปนี้เพื่อระบุว่า สมาชิกโครงสร้างถูกต้อง.

ค่า ความหมาย

CFM_ANIMATION สมาชิกbAnimationถูกต้อง.

CFM_BACKCOLOR สมาชิกcrBackColorถูกต้อง.

CFM_CHARSET สมาชิกbCharSetถูกต้อง.

CFM_COLOR สมาชิกcrTextColorถูกต้องยกเว้นค่าสถานะ CFE_AUTOCOLOR ถูกตั้งค่าในสมาชิกdwEffects.

CFM_FACE สมาชิกszFaceNameถูกต้อง.

CFM_KERNING สมาชิกwKerningถูกต้อง.

CFM_LCID สมาชิกlcidถูกต้อง.

CFM_OFFSET สมาชิกyOffsetถูกต้อง.

CFM_REVAUTHOR สมาชิกbRevAuthorถูกต้อง.

CFM_SIZE สมาชิกyHeightถูกต้อง.

CFM_SPACING สมาชิกsSpacingถูกต้อง.

CFM_STYLE สมาชิกsStyleถูกต้อง.

CFM_UNDERLINETYPE สมาชิกbUnderlineTypeถูกต้อง.

CFM_WEIGHT สมาชิกwWeightถูกต้อง.

ค่า	ความหมาย
CFM_ANIMATION	สมาชิกbAnimationถูกต้อง.
CFM_BACKCOLOR	สมาชิกcrBackColorถูกต้อง.
CFM_CHARSET	สมาชิกbCharSetถูกต้อง.
CFM_COLOR	สมาชิกcrTextColorถูกต้องยกเว้นค่าสถานะ CFE_AUTOCOLOR ถูกตั้งค่าในสมาชิกdwEffects.
CFM_FACE	สมาชิกszFaceNameถูกต้อง.
CFM_KERNING	สมาชิกwKerningถูกต้อง.
CFM_LCID	สมาชิกlcidถูกต้อง.
CFM_OFFSET	สมาชิกyOffsetถูกต้อง.
CFM_REVAUTHOR	สมาชิกbRevAuthorถูกต้อง.
CFM_SIZE	สมาชิกyHeightถูกต้อง.
CFM_SPACING	สมาชิกsSpacingถูกต้อง.
CFM_STYLE	สมาชิกsStyleถูกต้อง.
CFM_UNDERLINETYPE	สมาชิกbUnderlineTypeถูกต้อง.
CFM_WEIGHT	สมาชิกwWeightถูกต้อง.

ตั้งค่าต่อไปนี้เพื่อระบุว่า แอตทริบิวต์ที่ถูกต้องของสมาชิกdwEffects:

ค่า ความหมาย

CFM_ALLCAPS ค่า CFE_ALLCAPS ไม่ถูกต้อง.

CFM_BOLD ค่า CFE_BOLD ไม่ถูกต้อง.

CFM_COLOR ค่า CFE_AUTOCOLOR ไม่ถูกต้อง หรือสมาชิกcrTextColorถูกต้อง.

CFM_DISABLED ค่า CFE_DISABLED ไม่ถูกต้อง.

CFM_EMBOSS ค่า CFE_EMBOSS ไม่ถูกต้อง.

CFM_HIDDEN ค่า CFE_HIDDEN ไม่ถูกต้อง.

CFM_IMPRINT ค่า CFE_IMPRINT ไม่ถูกต้อง.

CFM_ITALIC ค่า CFE_ITALIC ไม่ถูกต้อง.

CFM_LINK ค่า CFE_LINK ไม่ถูกต้อง.

CFM_OUTLINE ค่า CFE_OUTLINE ไม่ถูกต้อง.

CFM_PROTECTED ค่า CFE_PROTECTED ไม่ถูกต้อง.

CFM_REVISED ค่า CFE_REVISION ไม่ถูกต้อง.

CFM_SHADOW ค่า CFE_SHADOW ไม่ถูกต้อง.

CFM_SMALLCAPS ค่า CFE_SMALLCAPS ไม่ถูกต้อง.

CFM_STRIKEOUT ค่า CFE_STRIKEOUT ไม่ถูกต้อง.

CFM_SUBSCRIPT ค่า CFE_SUBSCRIPT และ CFE_SUPERSCRIPT ถูกต้อง.

CFM_SUPERSCRIPT เหมือนกับ CFM_SUBSCRIPT.

CFM_UNDERLINE. ค่า CFE_UNDERLINE ไม่ถูกต้อง.

dwEffects

ค่า	ความหมาย
CFM_ALLCAPS	ค่า CFE_ALLCAPS ไม่ถูกต้อง.
CFM_BOLD	ค่า CFE_BOLD ไม่ถูกต้อง.
CFM_COLOR	ค่า CFE_AUTOCOLOR ไม่ถูกต้อง หรือสมาชิกcrTextColorถูกต้อง.
CFM_DISABLED	ค่า CFE_DISABLED ไม่ถูกต้อง.
CFM_EMBOSS	ค่า CFE_EMBOSS ไม่ถูกต้อง.
CFM_HIDDEN	ค่า CFE_HIDDEN ไม่ถูกต้อง.
CFM_IMPRINT	ค่า CFE_IMPRINT ไม่ถูกต้อง.
CFM_ITALIC	ค่า CFE_ITALIC ไม่ถูกต้อง.
CFM_LINK	ค่า CFE_LINK ไม่ถูกต้อง.
CFM_OUTLINE	ค่า CFE_OUTLINE ไม่ถูกต้อง.
CFM_PROTECTED	ค่า CFE_PROTECTED ไม่ถูกต้อง.
CFM_REVISED	ค่า CFE_REVISION ไม่ถูกต้อง.
CFM_SHADOW	ค่า CFE_SHADOW ไม่ถูกต้อง.
CFM_SMALLCAPS	ค่า CFE_SMALLCAPS ไม่ถูกต้อง.
CFM_STRIKEOUT	ค่า CFE_STRIKEOUT ไม่ถูกต้อง.
CFM_SUBSCRIPT	ค่า CFE_SUBSCRIPT และ CFE_SUPERSCRIPT ถูกต้อง.
CFM_SUPERSCRIPT	เหมือนกับ CFM_SUBSCRIPT.
CFM_UNDERLINE.	ค่า CFE_UNDERLINE ไม่ถูกต้อง.

ชุดของค่าสถานะบิตที่ระบุอักขระพิเศษ บางส่วนของค่าสถานะมีอยู่เฉพาะสำหรับความเข้ากันได้กับอินเทอร์เฟซแบบจำลองวัตถุข้อความของ Microsoft (ทอม) ตัวควบคุมการแก้ไขที่รวยเก็บค่า แต่ไม่ใช้เพื่อแสดงข้อความ.

สมาชิกนี้สามารถเป็นการรวมกันของค่าต่อไปนี้.

ค่า ความหมาย

CFE_ALLCAPS อักขระตัวพิมพ์ใหญ่ทั้งหมดได้ ไม่มีผลต่อวิธีการควบคุมการแสดงข้อความ.

CFE_AUTOCOLOR สีของข้อความถูกส่งคืนค่าของ GetSysColor (COLOR_WINDOWTEXT) หากถูกตั้งค่าสถานะนี้ สมาชิกcrTextColorจะถูกละเว้น.

CFE_BOLD อักขระเป็นตัวหนา.

CFE_DELETED ทำเครื่องหมายอักขระเป็นลบ.

CFE_EMBOSS มีดุนอักขระ ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.

CFE_HIDDEN อักขระไม่แสดง ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.

CFE_IMPRINT อักขระจะถูกแสดงเป็นอักขระ imprinted ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.

CFE_ITALIC อักขระเป็นตัวเอียง.

CFE_LINK ตัวควบคุมการแก้ไขที่รวยสามารถส่งข้อความแจ้งเตือนของEN_LINKเมื่อได้รับข้อความของเมาส์ในขณะที่ตัวชี้เมาส์อยู่เหนือข้อความที่มีลักษณะพิเศษ CFE_LINK.

CFE_OUTLINE อักขระจะถูกแสดงเป็นตัวอักษรเค้าร่าง ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.

CFE_PROTECTED อักขระจะคุ้ม ความพยายามในการปรับเปลี่ยนเหล่านี้จะทำให้เกิดข้อความแจ้งเตือนEN_PROTECTED.

CFE_REVISION ทำเครื่องหมายอักขระที่เป็นการแก้ไข.

CFE_SHADOW อักขระจะถูกแสดงเป็นอักขระที่แรเงา ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.

CFE_SMALLCAPS อักขระตัวพิมพ์ใหญ่ขนาดเล็กได้ ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.

CFE_STRIKEOUT ตัวอักษรที่ขีดออก.

CFE_SUBSCRIPT อักขระที่เป็นตัวห้อย ค่า CFE_SUPERSCRIPT และ CFE_SUBSCRIPT ที่แยกออกจากกันได้ สำหรับทั้งสองค่า ควบคุมการคำนวณโดยอัตโนมัติการชดเชยและขนาดแบบอักษรขนาดเล็กลง อีกวิธีหนึ่งคือ คุณสามารถใช้สมาชิกyHeightและyOffsetเพื่อระบุขนาดแบบอักษรและการชดเชยสำหรับอักขระตัวห้อย และตัวยกตัวอย่างชัดเจน.

CFE_SUPERSCRIPT อักขระที่เป็นตัวยก.

CFE_UNDERLINE ตัวอักษรที่ขีดเส้นใต้.

yHeight

ค่า	ความหมาย
CFE_ALLCAPS	อักขระตัวพิมพ์ใหญ่ทั้งหมดได้ ไม่มีผลต่อวิธีการควบคุมการแสดงข้อความ.
CFE_AUTOCOLOR	สีของข้อความถูกส่งคืนค่าของ GetSysColor (COLOR_WINDOWTEXT) หากถูกตั้งค่าสถานะนี้ สมาชิกcrTextColorจะถูกละเว้น.
CFE_BOLD	อักขระเป็นตัวหนา.
CFE_DELETED	ทำเครื่องหมายอักขระเป็นลบ.
CFE_EMBOSS	มีดุนอักขระ ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.
CFE_HIDDEN	อักขระไม่แสดง ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.
CFE_IMPRINT	อักขระจะถูกแสดงเป็นอักขระ imprinted ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.
CFE_ITALIC	อักขระเป็นตัวเอียง.
CFE_LINK	ตัวควบคุมการแก้ไขที่รวยสามารถส่งข้อความแจ้งเตือนของEN_LINKเมื่อได้รับข้อความของเมาส์ในขณะที่ตัวชี้เมาส์อยู่เหนือข้อความที่มีลักษณะพิเศษ CFE_LINK.
CFE_OUTLINE	อักขระจะถูกแสดงเป็นตัวอักษรเค้าร่าง ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.
CFE_PROTECTED	อักขระจะคุ้ม ความพยายามในการปรับเปลี่ยนเหล่านี้จะทำให้เกิดข้อความแจ้งเตือนEN_PROTECTED.
CFE_REVISION	ทำเครื่องหมายอักขระที่เป็นการแก้ไข.
CFE_SHADOW	อักขระจะถูกแสดงเป็นอักขระที่แรเงา ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.
CFE_SMALLCAPS	อักขระตัวพิมพ์ใหญ่ขนาดเล็กได้ ไม่มีผลต่อวิธีการที่ตัวควบคุมแสดงข้อความ.
CFE_STRIKEOUT	ตัวอักษรที่ขีดออก.
CFE_SUBSCRIPT	อักขระที่เป็นตัวห้อย ค่า CFE_SUPERSCRIPT และ CFE_SUBSCRIPT ที่แยกออกจากกันได้ สำหรับทั้งสองค่า ควบคุมการคำนวณโดยอัตโนมัติการชดเชยและขนาดแบบอักษรขนาดเล็กลง อีกวิธีหนึ่งคือ คุณสามารถใช้สมาชิกyHeightและyOffsetเพื่อระบุขนาดแบบอักษรและการชดเชยสำหรับอักขระตัวห้อย และตัวยกตัวอย่างชัดเจน.
CFE_SUPERSCRIPT	อักขระที่เป็นตัวยก.
CFE_UNDERLINE	ตัวอักษรที่ขีดเส้นใต้.

ระบุความสูงของอักขระ ใน twips Twip อยู่ 1/1440 ของนิ้ว หรือ 1/20 ของเครื่องพิมพ์แบบจุด การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_SIZE ในสมาชิกdwMask.

yOffset

ระบุอักขระออฟเซต ใน twips จากปกติ ถ้าสมาชิกนี้เป็นบวก อักขระเป็นตัวยก ถ้าเป็นค่าลบ อักขระเป็นตัวห้อย การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_OFFSET ในสมาชิกdwMask.

crTextColor

ระบุสีข้อความ การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_COLOR ในสมาชิกdwMask สมาชิกนี้จะถูกละเว้นถ้ามีระบุอักขระพิเศษ CFE_AUTOCOLOR.

bCharSet

ระบุอักขระที่กำหนดค่า ซึ่งเป็นหนึ่งในค่าที่ระบุสำหรับสมาชิกlfCharSetของ การ

LOGFONTโครงสร้าง การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_CHARSET ในสมาชิกdwMask.

bPitchAndFamily

ระบุตระกูลแบบอักษรและระยะห่าง สมาชิกนี้จะเหมือนกับสมาชิกlfPitchAndFamilyของโครงสร้างLOGFONT .

szFaceName

การสิ้นสุดด้วย null อักขระอาร์เรย์ในการระบุแบบอักษรหน้าชื่อ การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_FACE ในสมาชิกdwMask.

wWeight

ระบุน้ำหนักแบบอักษร สมาชิกนี้จะเหมือนกับสมาชิกlfWeightของโครงสร้างLOGFONT การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_WEIGHT ในสมาชิกdwMask.

sSpacing

ระบุระยะห่างแนวนอน ใน twips ระหว่างตัวอักษร ค่านี้ไม่มีผลกับข้อความที่แสดง โดยตัวควบคุมการแก้ไขที่รวย มันถูกรวมไว้สำหรับความเข้ากันได้กับอินเทอร์เฟซแบบจำลองวัตถุข้อความของ Microsoft (ทอม) การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_SPACING ในสมาชิกdwMask.

crBackColor

ระบุสีพื้นหลัง การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_BACKCOLOR ในสมาชิกdwMask.

lcid

ระบุตัวระบุตำแหน่งกระทำการ 32 บิตที่ประกอบด้วยตัวระบุภาษาในคำว่าต่ำกว่า และตัวระบุการเรียงลำดับ และค่าจองไว้ในคำสั่งด้านบน สมาชิกนี้ไม่มีผลกับข้อความที่แสดง โดยตัวควบคุมการแก้ไขที่รวย แต่ตัวตรวจสอบไวยากรณ์และการสะกดสามารถใช้จัดการกับปัญหาขึ้นอยู่กับภาษา คุณสามารถใช้การ

MAKELCIDแมโครเพื่อสร้างค่า LCID การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_LCID ในสมาชิกdwMask.

dwReserved

สงวน ต้องเป็นศูนย์.

sStyle

ระบุหมายเลขอ้างอิงลักษณะการ ค่านี้ไม่มีผลกับข้อความที่แสดง โดยตัวควบคุมการแก้ไขที่รวย มันถูกรวมไว้สำหรับความเข้ากันได้กับอินเทอร์เฟซแบบจำลองวัตถุข้อความของ Microsoft (ทอม) การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_STYLE ในสมาชิกdwMask.

wKerning

ระบุขนาด twip ข้างต้นซึ่งการปรับระยะห่างตัวอักขระ ค่านี้ไม่มีผลกับข้อความที่แสดง โดยตัวควบคุมการแก้ไขที่รวย มันถูกรวมไว้สำหรับความเข้ากันได้กับอินเทอร์เฟซของทอม การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_KERNING ในสมาชิกdwMask.

bUnderlineType

ระบุชนิดการขีดเส้นใต้ การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_UNDERLINETYPE ในสมาชิกdwMask สมาชิกนี้สามารถเป็นหนึ่งในค่าต่อไปนี้.

ค่า	ความหมาย
CFU_CF1UNDERLINE	ขีดเส้นใต้ของCHARFORMATของบิตแมปCHARFORMAT2.
CFU_INVERT	สำหรับองค์ประกอบของ IME ปลอมที่ส่วนที่เลือก.
CFU_UNDERLINE	เส้นใต้แบบเส้นทึบ.
CFU_UNDERLINEDOTTED	ข้อความถูกขีดเส้นใต้แบบจุด ตัวควบคุมการแก้ไขที่รวยแสดงข้อความที่ มีขีดเส้นใต้แบบเส้นทึบ.
CFU_UNDERLINEDOUBLE	ข้อความถูกขีดเส้นใต้คู่ ตัวควบคุมการแก้ไขที่รวยแสดงข้อความที่ มีขีดเส้นใต้แบบเส้นทึบ.
CFU_UNDERLINENONE	ไม่มีขีดเส้นใต้ นี่คือค่าเริ่มต้น.
CFU_UNDERLINEWORD	ขีดเส้นใต้คำเท่านั้น ตัวควบคุมการแก้ไขที่รวยแสดงข้อความที่ มีขีดเส้นใต้แบบเส้นทึบ.

bAnimation

ระบุข้อความเคลื่อนไหว ค่านี้ไม่มีผลกับข้อความที่แสดง โดยตัวควบคุมการแก้ไขที่รวย มันถูกรวมไว้สำหรับความเข้ากันได้กับอินเทอร์เฟซของทอม การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_ANIMATION ในสมาชิกdwMask.

bRevAuthor

ระบุดัชนีที่ระบุผู้เขียนทำให้แก้ไข ตัวควบคุมการแก้ไขที่รวยใช้สีของข้อความที่แตกต่างกันสำหรับแต่ละดัชนีผู้เขียนที่แตกต่างกัน การใช้สมาชิกนี้ ตั้งค่าสถานะ CFM_REVAUTHOR ในสมาชิกdwMask.

bReserved1

สงวน ต้องเป็นศูนย์.

QuickInfo

nbsp Windows &NT:ต้องการเวอร์ชัน 4.0 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ไม่สนับสนุน
หัวข้อ:ประกาศใน richedit.h
Unicode:กำหนดเป็นโครงสร้างแบบ Unicode และ ANSI.

ดูเพิ่มเติม

ภาพรวมของตัวควบคุมแก้ไข rich โครงสร้างแก้ไข Rich, CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index