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.

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
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
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