CHARFORMAT2

[Dit is voorlopige documentatie en onderhevig aan veranderingen.]

De CHARFORMAT2 structuur bevat informatie over tekenopmaak in een besturingselement rich edit. CHARFORMAT2 is een rijke bewerken 2.0 uitbreiding van de CHARFORMAT structuur. Rich edit 2.0 kunt u gebruiken beide de structuur met de EM_GETCHARFORMAT en EM_SETCHARFORMAT berichten.

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

Leden

cbSize

Geeft de grootte, in bytes, van deze structuur. Ingesteld voordat deze structuur naar een besturingselement rich edit, cbSize op de grootte van de CHARFORMAT of CHARFORMAT2 structuur. Als cbSize gelijk is aan de grootte van een CHARFORMAT structuur, het besturingselement gebruikt alleen de CHARFORMAT leden.

dwMask

Hiermee geeft u de delen van de CHARFORMAT2 structuur die geldige gegevens bevatten. Lid van de dwMask kunnen een combinatie van de waarden uit twee sets van bits vlaggen. Één set geeft aan de leden van de structuur die geldig zijn. Een andere set geeft aan de geldige kenmerken in de dwEffects lid.

Stel de volgende waarden om aan te geven de geldige structuur leden.

Waarde Betekenis

CFM_ANIMATION De bAnimation lid is geldig.

CFM_BACKCOLOR De crBackColor lid is geldig.

CFM_CHARSET De bCharSet lid is geldig.

CFM_COLOR Lid van de crTextColor is geldig, tenzij de CFE_AUTOCOLOR vlag is ingesteld in de dwEffects lid.

CFM_FACE De szFaceName lid is geldig.

CFM_KERNING De wKerning lid is geldig.

CFM_LCID De lcid lid is geldig.

CFM_OFFSET De yOffset lid is geldig.

CFM_REVAUTHOR De bRevAuthor lid is geldig.

CFM_SIZE De yHeight lid is geldig.

CFM_SPACING De sSpacing lid is geldig.

CFM_STYLE De sStyle lid is geldig.

CFM_UNDERLINETYPE De bUnderlineType lid is geldig.

CFM_WEIGHT De wWeight lid is geldig.

Waarde	Betekenis
CFM_ANIMATION	De bAnimation lid is geldig.
CFM_BACKCOLOR	De crBackColor lid is geldig.
CFM_CHARSET	De bCharSet lid is geldig.
CFM_COLOR	Lid van de crTextColor is geldig, tenzij de CFE_AUTOCOLOR vlag is ingesteld in de dwEffects lid.
CFM_FACE	De szFaceName lid is geldig.
CFM_KERNING	De wKerning lid is geldig.
CFM_LCID	De lcid lid is geldig.
CFM_OFFSET	De yOffset lid is geldig.
CFM_REVAUTHOR	De bRevAuthor lid is geldig.
CFM_SIZE	De yHeight lid is geldig.
CFM_SPACING	De sSpacing lid is geldig.
CFM_STYLE	De sStyle lid is geldig.
CFM_UNDERLINETYPE	De bUnderlineType lid is geldig.
CFM_WEIGHT	De wWeight lid is geldig.

Stel de volgende waarden om aan te geven de geldige kenmerken van de dwEffects lid:

Waarde Betekenis

CFM_ALLCAPS De waarde CFE_ALLCAPS is geldig.

CFM_BOLD De waarde CFE_BOLD is geldig.

CFM_COLOR De waarde CFE_AUTOCOLOR is geldig, of de crTextColor lid is geldig.

CFM_DISABLED De waarde CFE_DISABLED is geldig.

CFM_EMBOSS De waarde CFE_EMBOSS is geldig.

CFM_HIDDEN De waarde CFE_HIDDEN is geldig.

CFM_IMPRINT De waarde CFE_IMPRINT is geldig.

CFM_ITALIC De waarde CFE_ITALIC is geldig.

CFM_LINK De waarde CFE_LINK is geldig.

CFM_OUTLINE De waarde CFE_OUTLINE is geldig.

CFM_PROTECTED De waarde CFE_PROTECTED is geldig.

CFM_REVISED De waarde CFE_REVISION is geldig.

CFM_SHADOW De waarde CFE_SHADOW is geldig.

CFM_SMALLCAPS De waarde CFE_SMALLCAPS is geldig.

CFM_STRIKEOUT De waarde CFE_STRIKEOUT is geldig.

CFM_SUBSCRIPT De waarden CFE_SUBSCRIPT en CFE_SUPERSCRIPT zijn geldig.

CFM_SUPERSCRIPT Hetzelfde als CFM_SUBSCRIPT.

CFM_UNDERLINE. De waarde CFE_UNDERLINE is geldig.

dwEffects

Waarde	Betekenis
CFM_ALLCAPS	De waarde CFE_ALLCAPS is geldig.
CFM_BOLD	De waarde CFE_BOLD is geldig.
CFM_COLOR	De waarde CFE_AUTOCOLOR is geldig, of de crTextColor lid is geldig.
CFM_DISABLED	De waarde CFE_DISABLED is geldig.
CFM_EMBOSS	De waarde CFE_EMBOSS is geldig.
CFM_HIDDEN	De waarde CFE_HIDDEN is geldig.
CFM_IMPRINT	De waarde CFE_IMPRINT is geldig.
CFM_ITALIC	De waarde CFE_ITALIC is geldig.
CFM_LINK	De waarde CFE_LINK is geldig.
CFM_OUTLINE	De waarde CFE_OUTLINE is geldig.
CFM_PROTECTED	De waarde CFE_PROTECTED is geldig.
CFM_REVISED	De waarde CFE_REVISION is geldig.
CFM_SHADOW	De waarde CFE_SHADOW is geldig.
CFM_SMALLCAPS	De waarde CFE_SMALLCAPS is geldig.
CFM_STRIKEOUT	De waarde CFE_STRIKEOUT is geldig.
CFM_SUBSCRIPT	De waarden CFE_SUBSCRIPT en CFE_SUPERSCRIPT zijn geldig.
CFM_SUPERSCRIPT	Hetzelfde als CFM_SUBSCRIPT.
CFM_UNDERLINE.	De waarde CFE_UNDERLINE is geldig.

Een set van bits vlaggen die tekeneffecten opgeven. Sommige van de vlaggen zijn opgenomen alleen voor compatibiliteit met Microsoft tekst Object Model (TOM) interfaces; het besturingselement rich edit slaat de waarde maar gebruikt het geen tekst weergeven.

Dit lid kan bestaan uit een combinatie van de volgende waarden.

Waarde Betekenis

CFE_ALLCAPS Tekens zijn alle hoofdletters. Heeft geen invloed op de manier waarop die de tekst in het besturingselement weergegeven.

CFE_AUTOCOLOR De tekstkleur is de geretourneerde waarde van GetSysColor (COLOR_WINDOWTEXT). Als deze vlag is ingesteld, wordt lid van de crTextColor genegeerd.

CFE_BOLD Tekens zijn vet.

CFE_DELETED De tekens gemarkeerd als verwijderd.

CFE_EMBOSS Tekens in reliëf worden gemaakt. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.

CFE_HIDDEN Tekens worden niet weergegeven. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.

CFE_IMPRINT Tekens worden weergegeven als ingeprinte tekens. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.

CFE_ITALIC Tekens zijn cursief.

CFE_LINK Een besturingselement rich edit kunt EN_LINK meldingen verzenden wanneer het muis berichten ontvangt terwijl de muisaanwijzer over de tekst met het effect van CFE_LINK.

CFE_OUTLINE Tekens worden weergegeven als omkaderde tekens. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.

CFE_PROTECTED Tekens worden beschermd; een poging ze te wijzigen, zal een melding EN_PROTECTED.

CFE_REVISION De tekens zoals herzien markeert.

CFE_SHADOW Tekens worden weergegeven als met schaduw tekens. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.

CFE_SMALLCAPS Tekens worden in kleine kapitalen. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.

CFE_STRIKEOUT Tekens zijn doorgehaald.

CFE_SUBSCRIPT Tekens zijn subscript. De waarden CFE_SUPERSCRIPT en CFE_SUBSCRIPT zijn wederzijds exclusief. Voor beide waarden, wordt het besturingselement automatisch berekend een offset en een kleinere tekengrootte. U kunt de yHeight en yOffset leden tekengrootte en verschuiving voor subscript en superscript tekens expliciet opgeven.

CFE_SUPERSCRIPT Tekens zijn superscript.

CFE_UNDERLINE Tekens zijn onderstreept.

yHeight

Waarde	Betekenis
CFE_ALLCAPS	Tekens zijn alle hoofdletters. Heeft geen invloed op de manier waarop die de tekst in het besturingselement weergegeven.
CFE_AUTOCOLOR	De tekstkleur is de geretourneerde waarde van GetSysColor (COLOR_WINDOWTEXT). Als deze vlag is ingesteld, wordt lid van de crTextColor genegeerd.
CFE_BOLD	Tekens zijn vet.
CFE_DELETED	De tekens gemarkeerd als verwijderd.
CFE_EMBOSS	Tekens in reliëf worden gemaakt. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.
CFE_HIDDEN	Tekens worden niet weergegeven. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.
CFE_IMPRINT	Tekens worden weergegeven als ingeprinte tekens. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.
CFE_ITALIC	Tekens zijn cursief.
CFE_LINK	Een besturingselement rich edit kunt EN_LINK meldingen verzenden wanneer het muis berichten ontvangt terwijl de muisaanwijzer over de tekst met het effect van CFE_LINK.
CFE_OUTLINE	Tekens worden weergegeven als omkaderde tekens. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.
CFE_PROTECTED	Tekens worden beschermd; een poging ze te wijzigen, zal een melding EN_PROTECTED.
CFE_REVISION	De tekens zoals herzien markeert.
CFE_SHADOW	Tekens worden weergegeven als met schaduw tekens. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.
CFE_SMALLCAPS	Tekens worden in kleine kapitalen. Heeft geen invloed op hoe de tekst in het besturingselement wordt weergegeven.
CFE_STRIKEOUT	Tekens zijn doorgehaald.
CFE_SUBSCRIPT	Tekens zijn subscript. De waarden CFE_SUPERSCRIPT en CFE_SUBSCRIPT zijn wederzijds exclusief. Voor beide waarden, wordt het besturingselement automatisch berekend een offset en een kleinere tekengrootte. U kunt de yHeight en yOffset leden tekengrootte en verschuiving voor subscript en superscript tekens expliciet opgeven.
CFE_SUPERSCRIPT	Tekens zijn superscript.
CFE_UNDERLINE	Tekens zijn onderstreept.

Geeft het teken hoogte, uitgedrukt in twips. Een twip is 1/1440 van een duim, of 1/20 van de punt van een printer. Wilt gebruiken dit lid, stelt u de vlag CFM_SIZE in de dwMask lid.

yOffset

Geeft de offset aan karakter, uitgedrukt in twips, vanaf de basislijn. Als dit lid positief is, is het teken een superscript; Als het negatief is, is het teken een subscript. Wilt gebruiken dit lid, stelt u de vlag CFM_OFFSET in de dwMask lid.

crTextColor

Hiermee geeft u de tekstkleur van de. Wilt gebruiken dit lid, stelt u de vlag CFM_COLOR in de dwMask -lid. Dit lid wordt genegeerd als het effect van CFE_AUTOCOLOR teken is opgegeven.

bCharSet

Hiermee geeft u de tekensetwaarde, die kan een van de waarden die zijn opgegeven voor het lfCharSet lid van de

LOGFONT structuur. Wilt gebruiken dit lid, stelt u de vlag CFM_CHARSET in de dwMask lid.

bPitchAndFamily

Hiermee geeft u de lettertypefamilie en de toonhoogte. Dit lid is hetzelfde als het lid lfPitchAndFamily van de LOGFONT -structuur.

szFaceName

Een op null eindigende karakter array die de naam gezicht lettertype aangeeft. Wilt gebruiken dit lid, stelt u de vlag CFM_FACE in de dwMask lid.

wWeight

Hiermee geeft u het lettertype gewicht. Dit lid is hetzelfde als het lid lfWeight van de LOGFONT -structuur. Wilt gebruiken dit lid, stelt u de vlag CFM_WEIGHT in de dwMask lid.

sSpacing

Hiermee geeft u de horizontale afstand, uitgedrukt in twips, tussen letters. Deze waarde heeft geen effect op de tekst die wordt weergegeven door een besturingselement rich edit; het is opgenomen voor compatibiliteit met Microsoft tekst Object Model (TOM) interfaces. Wilt gebruiken dit lid, stelt u de vlag CFM_SPACING in de dwMask lid.

crBackColor

Hiermee geeft u de achtergrondkleur. Wilt gebruiken dit lid, stelt u de vlag CFM_BACKCOLOR in de dwMask lid.

lcid

Geeft een 32-bits locale identifier die een taal-id in het lagere woord, en een sorteer-id en gereserveerde waarde in de bovenste woord bevat. Dit lid heeft geen invloed op de tekst die wordt weergegeven door een besturingselement rich edit, maar spelling- en grammaticacontrole kunt gebruiken om taal-afhankelijke problemen aanpakken. U kunt de

MAKELCID macro een LCID-waarde te creëren. Wilt gebruiken dit lid, stelt u de vlag CFM_LCID in de dwMask lid.

dwReserved

Voorbehouden; moet nul zijn.

sStyle

Hiermee geeft u een stijl handvat. Deze waarde heeft geen effect op de tekst die wordt weergegeven door een besturingselement rich edit; het is opgenomen voor compatibiliteit met Microsoft tekst Object Model (TOM) interfaces. Wilt gebruiken dit lid, stelt u de vlag CFM_STYLE in de dwMask lid.

wKerning

Geeft de grootte twip waarboven moeten worden afgespatieerd het teken. Deze waarde heeft geen effect op de tekst die wordt weergegeven door een besturingselement rich edit; het is opgenomen voor compatibiliteit met interfaces van TOM. Wilt gebruiken dit lid, stelt u de vlag CFM_KERNING in de dwMask lid.

bUnderlineType

Geeft het type onderstreping. Wilt gebruiken dit lid, stelt u de vlag CFM_UNDERLINETYPE in de dwMask -lid. Dit lid kan een van de volgende waarden worden.

Waarde	Betekenis
CFU_CF1UNDERLINE	CHARFORMATvan bits onderstreping toewijzen aan CHARFORMAT2.
CFU_INVERT	Voor IME samenstelling fake een selectie.
CFU_UNDERLINE	Solide onderstreping.
CFU_UNDERLINEDOTTED	Gestippelde onderstreepte tekst. Het besturingselement rich edit wordt de tekst met een ononderbroken onderstreping weergegeven.
CFU_UNDERLINEDOUBLE	Dubbel onderstreepte tekst. Het besturingselement rich edit wordt de tekst met een ononderbroken onderstreping weergegeven.
CFU_UNDERLINENONE	Geen onderstreping. Dit is de standaardinstelling.
CFU_UNDERLINEWORD	Alleen woorden onderstrepen. Het besturingselement rich edit wordt de tekst met een ononderbroken onderstreping weergegeven.

bAnimation

Hiermee geeft u de tekstanimatie. Deze waarde heeft geen effect op de tekst die wordt weergegeven door een besturingselement rich edit; het is opgenomen voor compatibiliteit met interfaces van TOM. Wilt gebruiken dit lid, stelt u de vlag CFM_ANIMATION in de dwMask lid.

bRevAuthor

Hiermee geeft u een index waarmee de auteur maken een herziening. Het besturingselement rich edit gebruikt verschillende tekstkleuren voor elke verschillende Auteur index. Wilt gebruiken dit lid, stelt u de vlag CFM_REVAUTHOR in de dwMask lid.

bReserved1

Voorbehouden; moet nul zijn.

Syntaxisinfo

nbsp; Windows &NT: versie 4.0 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in richedit.h.
Unicode:Gedefinieerd als Unicode en ANSI structuren.

Zie ook

Rijk overzicht van besturingselementen bewerken, Rich Edit structuren, CHARFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index