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 הוא חוקי.

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