CHARFORMAT2

[Acest lucru este documenta?ia preliminare și subiect pentru a schimba].

Structura CHARFORMAT2 conține informații despre caracterul formatarea într-un control de editare bogat. CHARFORMAT2 este o extensie de editare bogat 2.0 de structura CHARFORMAT . Editare bogat 2.0 vă permite să utilizați fie structura cu mesajele EM_GETCHARFORMAT și EM_SETCHARFORMAT.

typedef struct _charformat2 {}
    UINT cbSize;
    _WPAD _wPad1;
    DWORD dwMask;
    DWORD dwEffects;
    YHeight lungi;
    YOffset lungi;
    COLORREF crTextColor;
    OCTET bCharSet;
    OCTET bPitchAndFamily;
    WCHAR szFaceName [LF_FACESIZE];
    _WPAD _wPad2;
    WORD wWeight;
    SSpacing scurt;
    COLORREF crBackColor;
    LCID lcid;
    DWORD dwReserved;
    SStyle scurt;
    WORD wKerning;
    OCTET bUnderlineType;
    OCTET bAnimation;
    OCTET bRevAuthor;
    OCTET bReserved1;
} CHARFORMAT2 

Membrii

cbSize
Specifică dimensiunea, în octeți, de această structură. Înainte de a trece această structură la un control de editare bogat, set cbSize la dimensiunea de structura CHARFORMAT sau CHARFORMAT2 . În cazul în care cbSize este egal cu dimensiunea de o structură CHARFORMAT , controlul utilizează numai membrii CHARFORMAT.
dwMask
Specifică părțile din structura CHARFORMAT2 care conțin informația validă. Membru dwMask pot fi o combinatie a valorilor din două seturi de biți steaguri. Un set indică structura membrii care sunt valabile. Un alt set indică atributele valabil membru dwEffects.

Setați următoarele valori pentru a indica membrii structura valabile.
Valoarea Sensul
CFM_ANIMATION BAnimation este valabilă.
CFM_BACKCOLOR CrBackColor este valabilă.
CFM_CHARSET BCharSet este valabilă.
CFM_COLOR CrTextColor este valabil dacă pavilion CFE_AUTOCOLOR este setat membru dwEffects.
CFM_FACE SzFaceName este valabilă.
CFM_KERNING WKerning este valabilă.
CFM_LCID Lcid este valabilă.
CFM_OFFSET YOffset este valabilă.
CFM_REVAUTHOR BRevAuthor este valabilă.
CFM_SIZE YHeight este valabilă.
CFM_SPACING SSpacing este valabilă.
CFM_STYLE SStyle este valabilă.
CFM_UNDERLINETYPE BUnderlineType este valabilă.
CFM_WEIGHT WWeight este valabilă.

Setați următoarele valori pentru a indica atributele valabil de membru dwEffects:
Valoarea Sensul
CFM_ALLCAPS Valoarea CFE_ALLCAPS este valabilă.
CFM_BOLD Valoarea CFE_BOLD este valabilă.
CFM_COLOR Valoarea CFE_AUTOCOLOR este validă, sau crTextColor este valabilă.
CFM_DISABLED Valoarea CFE_DISABLED este valabilă.
CFM_EMBOSS Valoarea CFE_EMBOSS este valabilă.
CFM_HIDDEN Valoarea CFE_HIDDEN este valabilă.
CFM_IMPRINT Valoarea CFE_IMPRINT este valabilă.
CFM_ITALIC Valoarea CFE_ITALIC este valabilă.
CFM_LINK Valoarea CFE_LINK este valabilă.
CFM_OUTLINE Valoarea CFE_OUTLINE este valabilă.
CFM_PROTECTED Valoarea CFE_PROTECTED este valabilă.
CFM_REVISED Valoarea CFE_REVISION este valabilă.
CFM_SHADOW Valoarea CFE_SHADOW este valabilă.
CFM_SMALLCAPS Valoarea CFE_SMALLCAPS este valabilă.
CFM_STRIKEOUT Valoarea CFE_STRIKEOUT este valabilă.
CFM_SUBSCRIPT Valorile CFE_SUBSCRIPT și CFE_SUPERSCRIPT sunt valabile.
CFM_SUPERSCRIPT Acela?i ca CFM_SUBSCRIPT.
CFM_UNDERLINE. Valoarea CFE_UNDERLINE este valabilă.

dwEffects
Un set de steaguri de biți care precizează caracterul efecte. Unele dintre steagurile sunt incluse numai pentru compatibilitate cu interfe?ele Model obiect Text Microsoft (TOM); comanda editare bogat stochează valoarea dar nu folos it pentru a afișa text.

Acest membru pot fi o combinatie de următoarele valori.
Valoarea Sensul
CFE_ALLCAPS De caractere sunt toate majuscule. Nu afectează modul în care controlul afișează textul.
CFE_AUTOCOLOR Culoarea textului este valoarea returnată de GetSysColor (COLOR_WINDOWTEXT). Dacă acest flag este setată, membru crTextColor este ignorat.
CFE_BOLD Personajele sunt bold.
CFE_DELETED Marchează caracterele ca elimină.
CFE_EMBOSS Caractere sunt imprimate în relief. Nu afectează modul în care controlul afișează textul.
CFE_HIDDEN Caractere nu sunt afișate. Nu afectează modul în care controlul afișează textul.
CFE_IMPRINT Caractere sunt afișate cu caractere inscripționare. Nu afectează modul în care controlul afișează textul.
CFE_ITALIC Personajele sunt cursiv.
CFE_LINK Un control de editare bogat poate trimite EN_LINK mesajele de notificare atunci când primește mesaje mouse-ului în timp ce indicatorul mouse-ului este de peste textul cu efect CFE_LINK.
CFE_OUTLINE Caractere sunt afișate cu caractere schițate. Nu afectează modul în care controlul afișează textul.
CFE_PROTECTED Caractere sunt protejate; o încercare de a le modifica va provoca un mesaj de notificare a EN_PROTECTED.
CFE_REVISION Marchează caracterele, revizuită.
CFE_SHADOW Caractere sunt afișate ca umbrit de caractere. Nu afectează modul în care controlul afișează textul.
CFE_SMALLCAPS Personajele sunt majuscule mici. Nu afectează modul în care controlul afișează textul.
CFE_STRIKEOUT Caractere sunt lovit.
CFE_SUBSCRIPT Personajele sunt indice. Valorile CFE_SUPERSCRIPT și CFE_SUBSCRIPT se exclud reciproc. Pentru ambele valori, controlul calculează automat un offset și o dimensiune de font mai mică. Alternativ, aveți posibilitatea să utilizați membrii yHeight și yOffset pentru a specifica explicit dimensiunea fontului și offset pentru caractere superscript și subscript.
CFE_SUPERSCRIPT Personajele sunt exponent.
CFE_UNDERLINE Caractere sunt subliniate.

yHeight
Specifică înălțimea de caractere, în twips. Un twip este 1/1440 dintr-un inch, sau 1/20 punctului o imprimantă. Pentru a utiliza acest membru, setați pavilion CFM_SIZE membru dwMask.
yOffset
Specifică decalajul de caractere, în twips, la linia de bază. Dacă acest membru este pozitiv, caracterul este un exponent; Dacă este negativ, caracterul este un indice. Pentru a utiliza acest membru, setați pavilion CFM_OFFSET membru dwMask.
crTextColor
Specifică culoarea textului. Pentru a utiliza acest membru, setați pavilion CFM_COLOR membru dwMask . Acest membru este ignorată dacă este specificat efectul de caractere CFE_AUTOCOLOR.
bCharSet
Specifică setul de caractere de valoare, care poate fi unul dintre valorile specificate pentru membru lfCharSet LOGFONT structura. Pentru a utiliza acest membru, setați pavilion CFM_CHARSET membru dwMask.
bPitchAndFamily
Specifică familie font și pitch. Acest membru este același ca membru lfPitchAndFamily din structura LOGFONT .
szFaceName
O matrice de null-terminated caractere care specifică numele față font. Pentru a utiliza acest membru, setați pavilion CFM_FACE membru dwMask.
wWeight
Precizează greutatea de font. Acest membru este același ca membru lfWeight de structura LOGFONT . Pentru a utiliza acest membru, setați pavilion CFM_WEIGHT membru dwMask.
sSpacing
Specifică spațiul orizontală, în twips, între litere. Această valoare nu are efect asupra textului afișat de un control de editare bogat; este inclus de compatibilitate cu interfe?ele Model obiect Text Microsoft (TOM). Pentru a utiliza acest membru, setați pavilion CFM_SPACING membru dwMask.
crBackColor
Specifică culoarea de fundal. Pentru a utiliza acest membru, setați pavilion CFM_BACKCOLOR membru dwMask.
lcid
Specifică un identificator de 32-bit locale care conține un identificator limbă în cuvântul mai mici, și un identificator de sortare și valoarea rezervate în cuvântul superioară. Acest membru nu are efect asupra textului afișat de un control de editare bogat, dar verificatoarele ortografice și gramaticale poate utiliza pentru a face față problemelor de limba. Aveți posibilitatea să utilizați MAKELCID macrocomanda pentru a crea o valoare LCID. Pentru a utiliza acest membru, setați pavilion CFM_LCID membru dwMask.
dwReserved
Rezervate; trebuie să fie zero.
sStyle
Specifică un mâner de stil. Această valoare nu are efect asupra textului afișat de un control de editare bogat; este inclus de compatibilitate cu interfe?ele Model obiect Text Microsoft (TOM). Pentru a utiliza acest membru, setați pavilion CFM_STYLE membru dwMask.
wKerning
Specifică dimensiunea twip mai sus pentru spațierea caracterului. Această valoare nu are efect asupra textului afișat de un control de editare bogat; este inclus de compatibilitate cu interfe?ele TOM. Pentru a utiliza acest membru, setați pavilion CFM_KERNING membru dwMask.
bUnderlineType
Specifică tipul de subliniere. Pentru a utiliza acest membru, setați pavilion CFM_UNDERLINETYPE membru dwMask . Acest membru poate fi una dintre următoarele valori.
Valoarea Sensul
CFU_CF1UNDERLINE Hartă CHARFORMATbit subliniere la CHARFORMAT2.
CFU_INVERT Pentru IME compozi?ia fake o selecție.
CFU_UNDERLINE Subliniere solide.
CFU_UNDERLINEDOTTED Textul subliniat punctată. Comanda editare bogat afișează textul subliniat cu o solidă.
CFU_UNDERLINEDOUBLE Dublu-a subliniat text. Comanda editare bogat afișează textul subliniat cu o solidă.
CFU_UNDERLINENONE Nici o subliniere. Aceasta este implicit.
CFU_UNDERLINEWORD Subliniază cuvintele numai. Comanda editare bogat afișează textul subliniat cu o solidă.

bAnimation
Specifică animație text. Această valoare nu are efect asupra textului afișat de un control de editare bogat; este inclus de compatibilitate cu interfe?ele TOM. Pentru a utiliza acest membru, setați pavilion CFM_ANIMATION membru dwMask.
bRevAuthor
Specifică un index care identifică autorul face o revizuire. Comanda editare bogat utilizează text diferite culori pentru fiecare index autor diferite. Pentru a utiliza acest membru, setați pavilion CFM_REVAUTHOR membru dwMask.
bReserved1
Rezervate; trebuie să fie zero.

QuickInfo

nbsp; Windows &NT: necesită versiunea 4.0 sau ulterioară.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Neacceptat.
Antet:A declarat în richedit.h.
Unicode:Definit ca structurile Unicode și ANSI.

A se vedea, de asemenea

Bogat Editare controale prezentare, structuri de editare bogat, CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index