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.

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

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.

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

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.

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