CHARFORMAT2

[זהו תיעוד ראשוני וניתנים לשינוי.]

המבנה CHARFORMAT2 מכיל מידע אודות עיצוב של פקד עריכה עשירה תווים. CHARFORMAT2 הוא סיומת עריכה עשירה 2.0 של מבנה CHARFORMAT . עריכה עשירה 2.0 מאפשר לך להשתמש בכל מבנה עם הודעות EM_GETCHARFORMAT ו- EM_SETCHARFORMAT.

typedef struct _charformat2 {
    UINT cbSize;
    _WPAD _wPad1;
    DWORD dwMask;
    DWORD dwEffects;
    YHeight ארוך;
    YOffset ארוך;
    COLORREF crTextColor;
    בית bCharSet;
    בית bPitchAndFamily;
    WCHAR szFaceName [LF_FACESIZE];
    _WPAD _wPad2;
    המילה wWeight;
    SSpacing קצרה;
    COLORREF crBackColor;
    LCID lcid;
    DWORD dwReserved;
    SStyle קצרה;
    המילה 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 (TOM); פקד עריכה עשירה מאחסן את הערך, אך לא להשתמש בו כדי להציג טקסט.

חבר זה יכול להיות שילוב של הערכים הבאים.

ערך משמעות

CFE_ALLCAPS תווים הם באותיות רישיות בלבד. אינה משפיעה על הדרך שהפקד מציג את הטקסט.

CFE_AUTOCOLOR צבע הטקסט הוא הערך המוחזר של GetSysColor (COLOR_WINDOWTEXT). אם דגל זה מוגדר, חבר crTextColor מתעלמת.

CFE_BOLD תווים מודגשים.

CFE_DELETED מסמן את התווים כמחוקים.

CFE_EMBOSS הבלטת של תווים. אינו משפיע על האופן שבו הפקד מציג את הטקסט.

CFE_HIDDEN תווים לא יוצגו. אינו משפיע על האופן שבו הפקד מציג את הטקסט.

CFE_IMPRINT התווים מוצגים תווים כך שהדיוור. אינו משפיע על האופן שבו הפקד מציג את הטקסט.

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	התווים מוצגים תווים כך שהדיוור. אינו משפיע על האופן שבו הפקד מציג את הטקסט.
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. טוויפ הוא 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 (TOM). כדי להשתמש איבר זה, להגדיר את הדגל CFM_SPACING חבר dwMask.

crBackColor

מציין את צבע הרקע. כדי להשתמש איבר זה, להגדיר את הדגל CFM_BACKCOLOR חבר dwMask.

מזהה אזור

ציון מזהה האזור 32 סיביות המכיל מזהה שפה ב- word התחתון, מזהה מיון ואת הערך השמור ב- word העליון. חבר זה אינה משפיעה על הטקסט המוצג על-ידי פקד עריכה עשירה, אך בודקי דקדוק ואיות ניתן להשתמש בו כדי לטפל בבעיות התלויים בשפה. באפשרותך להשתמש

MAKELCID מאקרו כדי ליצור ערך LCID. כדי להשתמש איבר זה, להגדיר את הדגל CFM_LCID חבר dwMask.

dwReserved

שמורות; חייב להיות אפס.

sStyle

ציון נקודת אחיזה סגנון. ערך זה אינה משפיעה על הטקסט המוצג על-ידי פקד עריכה עשירה; הוא נכלל לצורך תאימות עם ממשקים מודל אובייקט טקסט Microsoft (TOM). כדי להשתמש איבר זה, להגדיר את הדגל CFM_STYLE חבר dwMask.

wKerning

מציין את הגודל טוויפ שמעליה שינוי לובן אות על התו. ערך זה אינה משפיעה על הטקסט המוצג על-ידי פקד עריכה עשירה; הוא נכלל לצורך תאימות עם טום ממשקים. כדי להשתמש איבר זה, להגדיר את הדגל 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 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על richedit.h.
Unicode:מוגדר כ- Unicode ומבני ANSI.

ראה גם

עשיר לערוך סקירה כללית של פקדים, מבני עריכה עשיר, CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index