CHARFORMAT2

[Dette er foreløpige dokumentasjonen og endring.]

CHARFORMAT2 -strukturen inneholder informasjon om tegnformatering i en rich edit-kontrollen. CHARFORMAT2 er en rich edit 2.0 forlengelse av CHARFORMAT -strukturen. Rich edit 2.0 kan du bruke enten strukturen med EM_GETCHARFORMAT og EM_SETCHARFORMAT -meldinger.

typeDef struct _charformat2 {
    UINT cbSize;
    _WPAD _wPad1;
    DWORD dwMask;
    DWORD dwEffects;
    LANG yHeight;
    LANG yOffset;
    COLORREF crTextColor;
    BYTE bCharSet;
    BYTE bPitchAndFamily;
    WCHAR szFaceName [LF_FACESIZE];
    _WPAD _wPad2;
    WORD wWeight;
    KORT sSpacing;
    COLORREF crBackColor;
    LCID lcid;
    DWORD dwReserved;
    KORT sStyle;
    WORD wKerning;
    BYTE bUnderlineType;
    BYTE bAnimation;
    BYTE bRevAuthor;
    BYTE bReserved1;
} CHARFORMAT2 

Medlemmer

cbSize
Angir størrelsen, i byte, på denne strukturen. Før du sender denne strukturen til en rich edit-kontrollen, angir du cbSize til størrelsen på strukturen CHARFORMAT - eller CHARFORMAT2 . Hvis cbSize er lik størrelsen på en CHARFORMAT -struktur, bruker kontrollen bare CHARFORMAT medlemmer.
dwMask
Angir delene av CHARFORMAT2 -struktur som inneholder gyldig informasjon. DwMask -medlem kan være en kombinasjon av verdier fra to sett med Bitflagg. Ett sett angir strukturmedlemmer som er gyldige. Et annet sett angir gyldige attributter i dwEffects -medlem.

Angi følgende verdier å angi gyldig strukturmedlemmer.
Verdi Betydning
CFM_ANIMATION Det bAnimation er gyldig.
CFM_BACKCOLOR Det crBackColor er gyldig.
CFM_CHARSET Det bCharSet er gyldig.
CFM_COLOR CrTextColor -medlem er gyldig, med mindre flagget CFE_AUTOCOLOR er angitt i dwEffects -medlem.
CFM_FACE Det szFaceName er gyldig.
CFM_KERNING Det wKerning er gyldig.
CFM_LCID Lcid -medlem er gyldig.
CFM_OFFSET Det yOffset er gyldig.
CFM_REVAUTHOR Det bRevAuthor er gyldig.
CFM_SIZE Det yHeight er gyldig.
CFM_SPACING Det sSpacing er gyldig.
CFM_STYLE Det sStyle er gyldig.
CFM_UNDERLINETYPE Det bUnderlineType er gyldig.
CFM_WEIGHT Det wWeight er gyldig.

Angi følgende verdier å angi gyldige attributter av medlemmet dwEffects:
Verdi Betydning
CFM_ALLCAPS CFE_ALLCAPS-verdien er gyldig.
CFM_BOLD CFE_BOLD-verdien er gyldig.
CFM_COLOR CFE_AUTOCOLOR-verdien er gyldig, eller det crTextColor er gyldig.
CFM_DISABLED CFE_DISABLED-verdien er gyldig.
CFM_EMBOSS CFE_EMBOSS-verdien er gyldig.
CFM_HIDDEN CFE_HIDDEN-verdien er gyldig.
CFM_IMPRINT CFE_IMPRINT-verdien er gyldig.
CFM_ITALIC CFE_ITALIC-verdien er gyldig.
CFM_LINK CFE_LINK-verdien er gyldig.
CFM_OUTLINE CFE_OUTLINE-verdien er gyldig.
CFM_PROTECTED CFE_PROTECTED-verdien er gyldig.
CFM_REVISED CFE_REVISION-verdien er gyldig.
CFM_SHADOW CFE_SHADOW-verdien er gyldig.
CFM_SMALLCAPS CFE_SMALLCAPS-verdien er gyldig.
CFM_STRIKEOUT CFE_STRIKEOUT-verdien er gyldig.
CFM_SUBSCRIPT Verdiene CFE_SUBSCRIPT og CFE_SUPERSCRIPT er gyldig.
CFM_SUPERSCRIPT Samme som CFM_SUBSCRIPT.
CFM_UNDERLINE. CFE_UNDERLINE-verdien er gyldig.

dwEffects
Et sett med Bitflagg som angir tegneffekter. Noen av flaggene er inkludert bare for kompatibilitet med Microsoft tekst objekt modell (TOM) grensesnitt; rich edit-kontrollen lagrer verdien, men bruker ikke den til å vise tekst.

Dette medlemmet kan være en kombinasjon av følgende verdier.
Verdi Betydning
CFE_ALLCAPS Tegn er bare store bokstaver. Påvirker ikke måten viser teksten i kontrollen.
CFE_AUTOCOLOR Tekstfargen er verdien som returneres av GetSysColor (COLOR_WINDOWTEXT). Hvis dette flagget er angitt, ignoreres crTextColor -medlemmet.
CFE_BOLD Tegn er fet.
CFE_DELETED Markeres tegnene som slettet.
CFE_EMBOSS Tegn er preget. Påvirker ikke hvordan kontrollen viser teksten.
CFE_HIDDEN Tegn vises ikke. Påvirker ikke hvordan kontrollen viser teksten.
CFE_IMPRINT Tegn vises som klistres tegn. Påvirker ikke hvordan kontrollen viser teksten.
CFE_ITALIC Tegn er kursiv.
CFE_LINK Rich edit-kontrollen kan sende varselmeldinger for EN_LINK når den mottar meldinger med musen mens musepekeren er over teksten med CFE_LINK-effekt.
CFE_OUTLINE Tegn vises som disponerte tegn. Påvirker ikke hvordan kontrollen viser teksten.
CFE_PROTECTED Tegn er beskyttet; et forsøk på å endre dem, vil føre til en varslingsmelding EN_PROTECTED.
CFE_REVISION Markerer tegnene som reviderte.
CFE_SHADOW Tegn vises som skyggelagt tegn. Påvirker ikke hvordan kontrollen viser teksten.
CFE_SMALLCAPS Tegnene er i kapitéler. Påvirker ikke hvordan kontrollen viser teksten.
CFE_STRIKEOUT Tegn er gjennomstreket.
CFE_SUBSCRIPT Tegn er senket skrift. Verdiene CFE_SUPERSCRIPT og CFE_SUBSCRIPT er gjensidig ekskluderende. Om to verdier beregner kontrollen automatisk en forskyvning og en mindre skriftstørrelse. Du kan også bruke yHeight og yOffset -medlemmer å eksplisitt angi skriftstørrelse og forskyvningen for tegn med grense i senket og hevet skrift.
CFE_SUPERSCRIPT Tegn er hevet skrift.
CFE_UNDERLINE Tegn er understreket.

yHeight
Angir høyden tegn i twips. En twip er 1/1440 av en tomme eller 1/20 punkt for en skriver. For å bruke dette medlemmet, sette CFM_SIZE-flagget i dwMask -medlem.
yOffset
Angir forskyvningen tegn, i twiper, fra den opprinnelige planen. Hvis dette medlemmet er positivt, er tegnet en hevet skrift; Hvis verdien er negativ, er tegnet en senket skrift. For å bruke dette medlemmet, sette CFM_OFFSET-flagget i dwMask -medlem.
crTextColor
Angir tekstfargen. Hvis du vil bruke dette medlemmet, sett flagget CFM_COLOR i dwMask -medlem. Dette medlemmet ignoreres hvis CFE_AUTOCOLOR tegn effekten er angitt.
bCharSet
Angir tegnet angitt verdi, som kan være en av verdiene som er angitt for lfCharSet medlem av den LOGFONT struktur. For å bruke dette medlemmet, sette CFM_CHARSET-flagget i dwMask -medlem.
bPitchAndFamily
Angir skriftfamilien og tonehøyde. Dette medlemmet er det samme som lfPitchAndFamily -medlem av LOGFONT -struktur.
szFaceName
En null-terminert tegn-matrisen angir skriftnavnet ansikt. For å bruke dette medlemmet, sette CFM_FACE-flagget i dwMask -medlem.
wWeight
Angir font-weight. Dette medlemmet er det samme som lfWeight -medlem av LOGFONT -strukturen. For å bruke dette medlemmet, sette CFM_WEIGHT-flagget i dwMask -medlem.
sSpacing
Angir den vannrette avstanden, i twiper, mellom bokstaver. Denne verdien har ingen innvirkning på teksten som vises ved en rich edit-kontrollen; Det er inkludert for kompatibilitet med Microsoft tekst objekt modell (TOM)-grensesnitt. For å bruke dette medlemmet, sette CFM_SPACING-flagget i dwMask -medlem.
crBackColor
Angir bakgrunnsfargen. For å bruke dette medlemmet, sette CFM_BACKCOLOR-flagget i dwMask -medlem.
lcid
Angir en 32-biters Regionsidentifikatoren som inneholder en språkidentifikatoren i det nedre ordet og en sorterings-ID og en reservert verdi i det øverste ordet. Denne har ingen innvirkning på teksten som vises ved en rich edit-kontrollen, men stave- og grammatikkontroller kan bruke den til å håndtere språkavhengige problemer. Du kan bruke den MAKELCID -makro for å opprette en LCID-verdi. For å bruke dette medlemmet, sette CFM_LCID-flagget i dwMask -medlem.
dwReserved
Reservert; må være null.
sStyle
Hvis du angir en stil-håndtak. Denne verdien har ingen innvirkning på teksten som vises ved en rich edit-kontrollen; Det er inkludert for kompatibilitet med Microsoft tekst objekt modell (TOM)-grensesnitt. For å bruke dette medlemmet, sette CFM_STYLE-flagget i dwMask -medlem.
wKerning
Angir størrelsen på twip ovenfor som å knipe tegnet. Denne verdien har ingen innvirkning på teksten som vises ved en rich edit-kontrollen; Det er inkludert for kompatibilitet med TOM grensesnitt. For å bruke dette medlemmet, sette CFM_KERNING-flagget i dwMask -medlem.
bUnderlineType
Angir understreking. Hvis du vil bruke dette medlemmet, sett flagget CFM_UNDERLINETYPE i dwMask -medlem. Dette medlemmet kan være en av følgende verdier.
Verdi Betydning
CFU_CF1UNDERLINE Tilordne CHARFORMATbit understreking til CHARFORMAT2.
CFU_INVERT Fake et utvalg for IME-sammensetning.
CFU_UNDERLINE Solid understreking.
CFU_UNDERLINEDOTTED Prikket understreking. Rich edit-kontrollen viser teksten med en solid understreking.
CFU_UNDERLINEDOUBLE Dobbelt understreket tekst. Rich edit-kontrollen viser teksten med en solid understreking.
CFU_UNDERLINENONE Ingen understreking. Dette er standard.
CFU_UNDERLINEWORD Streke under ord bare. Rich edit-kontrollen viser teksten med en solid understreking.

bAnimation
Angir tekstanimasjonen. Denne verdien har ingen innvirkning på teksten som vises ved en rich edit-kontrollen; Det er inkludert for kompatibilitet med TOM grensesnitt. For å bruke dette medlemmet, sette CFM_ANIMATION-flagget i dwMask -medlem.
bRevAuthor
Angir en indeks som identifiserer forfatteren gjør en revisjon. Rich edit-kontrollen bruker ulike farger for hver annen redigerer indeks. For å bruke dette medlemmet, sette CFM_REVAUTHOR-flagget i dwMask -medlem.
bReserved1
Reservert; må være null.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 4.0 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i richedit.h.
Unicode:Definert som Unicode- og ANSI-strukturer.

Se også

Rik redigere kontroller oversikt, Rediger strukturer, CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index