Freigeben über

CHARFORMAT2W Struktur (Rich Edit 2.0)

  • Artikel

Enthält Informationen zur Zeichenformatierung in einem Rich-Edit-Steuerelement. CHARFORMAT2 ist eine Microsoft Rich Edit 2.0-Erweiterung der CHARFORMAT--Struktur. Mit Microsoft Rich Edit 2.0 können Sie eine der beiden Strukturen mit den EM_GETCHARFORMAT und EM_SETCHARFORMAT Nachrichten verwenden.

Syntax

typedef struct _charformat2w {
  UINT     cbSize;
  DWORD    dwMask;
  DWORD    dwEffects;
  LONG     yHeight;
  LONG     yOffset;
  COLORREF crTextColor;
  BYTE     bCharSet;
  BYTE     bPitchAndFamily;
  WCHAR    szFaceName[LF_FACESIZE];
  WORD     wWeight;
  SHORT    sSpacing;
  COLORREF crBackColor;
  LCID     lcid;
  union {
    DWORD dwReserved;
    DWORD dwCookie;
  };
  DWORD    dwReserved;
  SHORT    sStyle;
  WORD     wKerning;
  BYTE     bUnderlineType;
  BYTE     bAnimation;
  BYTE     bRevAuthor;
  BYTE     bUnderlineColor;
} CHARFORMAT2W;

Angehörige

cbSize

Typ: UINT-

Gibt die Größe der Struktur in Bytes an. Bevor Sie diese Struktur an ein Rich-Edit-Steuerelement übergeben, legen Sie cbSize- auf die Größe der CHARFORMAT- oder CHARFORMAT2 Struktur fest. Wenn cbSize- der Größe einer CHARFORMAT--Struktur entspricht, verwendet das Steuerelement nur die CHARFORMAT--Member.

dwMask

Typ: DWORD-

Gibt die Teile der CHARFORMAT2 Struktur an, die gültige Informationen enthalten. Das dwMask Member kann eine Kombination der Werte aus zwei Bit-Flags sein. Ein Satz gibt die gültigen Strukturmber an. Ein weiterer Satz gibt die gültigen Attribute im dwEffects Member an.

Legen Sie die folgenden Werte fest, um die gültigen Attribute des dwEffects Member anzugeben.

Wert Bedeutung
CFM_ALL
 Eine Kombination der folgenden Werte: CFM_EFFECTS | CFM_SIZE | CFM_FACE | CFM_OFFSET | CFM_CHARSET
CFM_ALL2
 Eine Kombination der folgenden Werte: CFM_ALL | CFM_EFFECTS2 | CFM_BACKCOLOR | CFM_LCID | CFM_UNDERLINETYPE | CFM_WEIGHT | CFM_REVAUTHOR | CFM_SPACING | CFM_KERNING | CFM_STYLE | CFM_ANIMATION | CFM_COOKIE
CFM_ALLCAPS
 Der CFE_ALLCAPS Wert ist gültig.
CFM_EFFECTS
 Eine Kombination der folgenden Werte: CFM_EFFECTS2 | CFM_FONTBOUND | CFM_EXTENDED | CFM_MATHNOBUILDUP | CFM_MATH | CFM_MATHORDINARY
CFM_BOLD
 Der CFE_BOLD Wert ist gültig.
CFM_COLOR
 Der CFE_AUTOCOLOR Wert ist gültig, oder der crTextColor Member ist gültig.
CFM_COOKIE
 Der dwCookie Wert ist gültig.
CFM_DISABLED
 Der CFE_DISABLED Wert ist gültig.
CFM_EXTENDED
 Der CFE_EXTENDED Wert ist gültig.
CFM_EFFECTS
 Eine Kombination der folgenden Werte: CFM_BOLD | CFM_ITALIC | CFM_UNDERLINE | CFM_COLOR | CFM_STRIKEOUT | CFE_PROTECTED | CFM_LINK
CFM_EFFECTS2
 Eine Kombination der folgenden Werte: CFM_EFFECTS | CFM_DISABLED | CFM_SMALLCAPS | CFM_ALLCAPS | CFM_HIDDEN | CFM_OUTLINE | CFM_SHADOW | CFM_EMBOSS | CFM_IMPRINT | CFM_REVISED | CFM_SUBSCRIPT | CFM_SUPERSCRIPT | CFM_BACKCOLOR
CFM_EMBOSS
 Der CFE_EMBOSS Wert ist gültig.
CFM_FONTBOUND
 Der CFE_FONTBOUND Wert ist gültig.
CFM_HIDDEN
 Der CFE_HIDDEN Wert ist gültig.
CFM_IMPRINT
 Der CFE_IMPRINT Wert ist gültig.
CFM_ITALIC
 Der CFE_ITALIC Wert ist gültig.
CFM_LINK
 Der CFE_LINK Wert ist gültig.
CFM_LINKPROTECTED
 Der CFE_LINKPROTECTED Wert ist gültig.
CFM_MATH
 Der CFE_MATH Wert ist gültig.
CFM_MATHNOBUILDUP
 Der CFE_MATHNOBUILDUP Wert ist gültig.
CFM_MATHORDINARY
 Der CFE_MATHORDINARY Wert ist gültig.
CFM_OUTLINE
 Der CFE_OUTLINE Wert ist gültig.
CFM_PROTECTED
 Der CFE_PROTECTED Wert ist gültig.
CFM_REVISED
 Der CFE_REVISION Wert ist gültig.
CFM_SHADOW
 Der CFE_SHADOW Wert ist gültig.
CFM_SMALLCAPS
 Der CFE_SMALLCAPS Wert ist gültig.
CFM_STRIKEOUT
 Der CFE_STRIKEOUT Wert ist gültig.
CFM_SUBSCRIPT
 Die werte CFE_SUBSCRIPT und CFE_SUPERSCRIPT sind gültig.
CFM_SUPERSCRIPT
 Die werte CFE_SUBSCRIPT und CFE_SUPERSCRIPT sind gültig.
CFM_UNDERLINE
 Der CFE_UNDERLINE Wert ist gültig.
 

Legen Sie die folgenden Werte fest, um die gültigen Strukturmber anzugeben.

Wert Bedeutung
CFM_ANIMATION
 Das bAnimation Member ist gültig.
CFM_BACKCOLOR
 Das crBackColor Member ist gültig.
CFM_CHARSET
 Das bCharSet Member ist gültig.
CFM_COLOR
 Das crTextColor Member ist gültig, es sei denn, das CFE_AUTOCOLOR Flag ist im dwEffects Member festgelegt.
CFM_FACE
 Das szFaceName Member ist gültig.
CFM_KERNING
 Das wKerning Member ist gültig.
CFM_LCID
 Das lcid Member ist gültig.
CFM_OFFSET
 Das yOffset Member ist gültig.
CFM_REVAUTHOR
 Das bRevAuthor Member ist gültig.
CFM_SIZE
 Das yHeight Member ist gültig.
CFM_SPACING
 Das sSpacing Member ist gültig.
CFM_STYLE
 Das sStyle Member ist gültig.
CFM_UNDERLINETYPE
 Das bUnderlineType Member ist gültig.
CFM_WEIGHT
 Das wWeight Member ist gültig.

dwEffects

Typ: DWORD-

Eine Gruppe von Bitkennzeichnungen, die Zeicheneffekte angeben. Einige der Flags sind nur zur Kompatibilität mit Microsoft Textobjektmodell- (TOM)-Schnittstellen enthalten; Das Rich Edit-Steuerelement speichert den Wert, verwendet ihn jedoch nicht zum Anzeigen von Text.

Dieses Element kann eine Kombination aus den folgenden Werten sein.

Wert Bedeutung
CFE_ALLCAPS
 Zeichen sind alle Großbuchstaben. Der Wert wirkt sich nicht auf die Art und Weise aus, wie das Steuerelement den Text anzeigt. Dieser Wert gilt nur für Versionen vor Microsoft Rich Edit 3.0.
CFE_AUTOBACKCOLOR
 Die Hintergrundfarbe ist der Rückgabewert von GetSysColor(COLOR_WINDOW). Wenn dieses Flag festgelegt ist, wird crBackColor- Element ignoriert.
CFE_AUTOCOLOR
 Die Textfarbe ist der Rückgabewert von GetSysColor(COLOR_WINDOWTEXT). Wenn dieses Flag festgelegt ist, wird das crTextColor Member ignoriert.
CFE_BOLD
 Zeichen sind fett formatiert.
CFE_DISABLED
 Zeichen werden mit einem Schatten angezeigt, der um 3/4 Punkt oder ein Pixel versetzt wird, je nachdem, welcher Wert größer ist.
CFE_EMBOSS
 Zeichen werden geprägt. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt.
CFE_EXTENDED
 Die Zeichen sind weniger häufig verwendete Elemente eines Skripts. Eine Schriftart, die ein Skript unterstützt, sollte überprüfen, ob sie Glyphen für solche Zeichen enthält.
CFE_FONTBOUND
 Die Schriftart wird vom Rich-Edit-Steuerelement ausgewählt, da die aktive Schriftart die Zeichen nicht unterstützt. Dieser Prozess wird als Schriftbindung bezeichnet.
CFE_HIDDEN
 Für Microsoft Rich Edit 3.0 und höher werden keine Zeichen angezeigt.
CFE_IMPRINT
 Zeichen werden als beschriftete Zeichen angezeigt. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt.
CFE_ITALIC
 Zeichen sind kursiv.
CFE_LINK
 Ein Rich-Edit-Steuerelement kann EN_LINK Benachrichtigungscodes senden, wenn es Mausnachrichten empfängt, während der Mauszeiger über Text mit dem CFE_LINK Effekt liegt.
CFE_LINKPROTECTED
 Zeichen sind Teil eines Anzeigenamenlinks.
CFE_MATH
 Zeichen befinden sich in einer mathematischen Zone.
CFE_MATHNOBUILDUP
 Zeichen nehmen nicht an einem mathematischen Aufbau teil. Wenn sie z. B. auf "/" angewendet wird, wird das /-Objekt nicht verwendet, um einen Bruch zu erstellen.
CFE_MATHORDINARY
 Zeichen werden als normaler Text in einer mathematischen Zone angezeigt.
CFE_OUTLINE
 Zeichen werden als umrissierte Zeichen angezeigt. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt.
CFE_PROTECTED
 Zeichen sind geschützt; Ein Versuch, sie zu ändern, führt zu einem EN_PROTECTED Benachrichtigungscode.
CFE_REVISED
 Zeichen werden als überarbeitet markiert.
CFE_SHADOW
 Zeichen werden als schattierte Zeichen angezeigt. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt.
CFE_SMALLCAPS
 Zeichen sind in kleinbuchstaben. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt.
CFE_STRIKEOUT
 Zeichen sind ausgeschlagen.
CFE_SUBSCRIPT
 Zeichen sind tiefgestellt. Die werte CFE_SUPERSCRIPT und CFE_SUBSCRIPT schließen sich gegenseitig aus. Für beide Werte berechnet das Steuerelement automatisch einen Offset und einen kleineren Schriftgrad. Alternativ können Sie die yHeight- und yOffset--Member verwenden, um den Schriftgrad und den Offset für tiefgestellte und hochgestellte Zeichen explizit anzugeben.
CFE_SUPERSCRIPT
 Zeichen sind hochgestellt.
CFE_UNDERLINE
 Zeichen werden unterstrichen.

yHeight

Typ: LONG

Gibt die Zeichenhöhe in Twips (1/1440 zoll oder 1/20 des Druckerpunkts) an. Um dieses Element zu verwenden, legen Sie das CFM_SIZE Flag im dwMask--Element fest.

yOffset

Typ: LONG

Zeichenoffset von der Basislinie in Twips. Wenn der Wert dieses Elements positiv ist, ist das Zeichen hochgestellt; wenn der Wert negativ ist, ist das Zeichen ein Tiefgestellt. Um dieses Element zu verwenden, legen Sie das CFM_OFFSET Flag im dwMask Member fest.

crTextColor

Typ: COLORREF-

Textfarbe. Um dieses Element zu verwenden, legen Sie das CFM_COLOR Flag im dwMask Member fest. Dieses Element wird ignoriert, wenn der CFE_AUTOCOLOR Zeicheneffekt angegeben ist. Verwenden Sie zum Generieren eines COLORREF-das RGB- Makro.

bCharSet

Typ: BYTE-

Zeichensatzwert. Es kann sich um einen der für das lfCharSet Member der LOGFONT--Struktur angegebenen Werte handeln. Um dieses Element zu verwenden, legen Sie das CFM_CHARSET Flag im dwMask Member fest.

bPitchAndFamily

Typ: BYTE-

Gibt die Schriftfamilie und den Schriftabstand an. Dieses Element ist identisch mit dem lfPitchAndFamily Mitglied der LOGFONT Struktur.

szFaceName[LF_FACESIZE]

Typ: TCHAR[LF_FACESIZE]

Ein mit Null beendetes Zeichenarray, das den Schriftartnamen angibt. Um dieses Element zu verwenden, legen Sie das CFM_FACE Flag im dwMask Member fest.

wWeight

Typ: WORD-

Schriftbreite. Dieses Element ist identisch mit dem lfWeight Member der LOGFONT--Struktur. Um dieses Element zu verwenden, legen Sie das CFM_WEIGHT Flag im dwMask Member fest.

sSpacing

Typ: SHORT

Horizontaler Abstand zwischen Buchstaben in Twips. Dieser Wert hat keine Auswirkungen auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird; sie ist für die Kompatibilität mit Windows TOM-Schnittstellen enthalten. Um dieses Element zu verwenden, legen Sie das CFM_SPACING Flag im dwMask--Element fest.

crBackColor

Typ: COLORREF-

Hintergrundfarbe. Um dieses Element zu verwenden, legen Sie das CFM_BACKCOLOR Flag im dwMask Member fest. Dieses Element wird ignoriert, wenn der CFE_AUTOBACKCOLOR Zeicheneffekt angegeben wird. Verwenden Sie das Makro, um ein Makro zu generieren.

lcid

Typ: LCID-

Ein 32-Bit-Gebietsschemabezeichner, der einen Sprachbezeichner im unteren Wort und einen Sortierbezeichner und einen reservierten Wert im oberen Wort enthält. Dieses Element hat keine Auswirkungen auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird, aber die Rechtschreib- und Grammatikprüfung kann ihn verwenden, um sprachabhängige Probleme zu behandeln. Sie können das Makro verwenden, um einen LCID- Wert zu erstellen. Um dieses Element zu verwenden, legen Sie das CFM_LCID Flag im dwMask--Element fest.

dwReserved

Typ: DWORD-

Reserviert; der Wert muss null sein.

dwCookie

Typ: DWORD-

Clientcookies. Dieses Element ist für ein Rich-Edit-Steuerelement nicht transparent.

sStyle

Typ: SHORT

Ziehpunkt für Zeichenformatvorlagen. Dieser Wert hat keine Auswirkungen auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird; sie ist zur Kompatibilität mit WindowsTOM-Schnittstellen enthalten. Um dieses Element zu verwenden, legen Sie das CFM_STYLE Flag im dwMask Member fest. Weitere Informationen finden Sie in der TOM-Dokumentation.

wKerning

Typ: WORD-

Wert des Schriftgrads, über dem das Zeichen gekernt werden soll (yHeight). Dieser Wert hat keine Auswirkungen auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird; sie ist zur Kompatibilität mit TOM-Schnittstellen enthalten. Um dieses Element zu verwenden, legen Sie das CFM_KERNING Flag im dwMask--Element fest.

bUnderlineType

Typ: BYTE-

Gibt den Unterstreichungstyp an. Um dieses Element zu verwenden, legen Sie das CFM_UNDERLINETYPE Flag im dwMask Member fest. Dieses Element kann einer der folgenden Werte sein:

Wert Bedeutung
CFU_CF1UNDERLINE
 Die Struktur ordnet CHARFORMATBit-Unterstreichung CHARFORMAT2zu (d. a. es führt eine CHARFORMAT- Art der Unterstreichung in diesem Text aus).
CFU_INVERT
 Für DIE IME-Komposition fälschen Sie eine Auswahl.
CFU_UNDERLINE
 Text unterstrichen mit einer einzelnen einfarbigen Linie.
CFU_UNDERLINEDASH
 Text unterstrichen mit Bindestrichen.
CFU_UNDERLINEDASHDOT
 Text unterstrichen mit gestrichelter und gepunkteter Linie.
CFU_UNDERLINEDASHDOTDOT
 Text unterstrichen mit gestrichelter und doppelter gepunkteter Linie.
CFU_UNDERLINEDOTTED
 Text unterstrichen mit einer gepunkteten Linie. Für Versionen vor Microsoft Rich Edit 3.0 wird Text mit einer einfarbigen Unterstreichung angezeigt.
CFU_UNDERLINEDOUBLE
 Text unterstrichen mit einer doppelzeiligen Linie. Das Rich-Edit-Steuerelement zeigt den Text mit einer einfarbigen Unterstreichung an.
CFU_UNDERLINEDOUBLEWAVE
 Als CFU_UNDERLINEWAVEanzeigen.
CFU_UNDERLINEHAIRLINE
 Als CFU_UNDERLINEanzeigen .
CFU_UNDERLINEHEAVYWAVE
 Als CFU_UNDERLINEWAVEanzeigen.
CFU_UNDERLINELONGDASH
 Als CFU_UNDERLINEDASHanzeigen .
CFU_UNDERLINENONE
 Keine Unterstreichung. Dies ist die Standardeinstellung.
CFU_UNDERLINETHICK
 Als CFU_UNDERLINEanzeigen .
CFU_UNDERLINETHICKDASH
 Als CFU_UNDERLINEDASHanzeigen .
CFU_UNDERLINETHICKDASHDOT
 Als CFU_UNDERLINEDASHDOTanzeigen.
CFU_UNDERLINETHICKDASHDOTDOT
 Als CFU_UNDERLINEDASHDOTanzeigen.
CFU_UNDERLINETHICKDOTTED
 Als CFU_UNDERLINEDOTanzeigen .
CFU_UNDERLINETHICKLONGDASH
 Als CFU_UNDERLINEDASHanzeigen .
CFU_UNDERLINEWAVE
 RichEdit 4.1 und höher: Text unterstrichen mit einer wellenförmigen Linie.
CFU_UNDERLINEWORD
 RichEdit 4.1 und höher: Nur Wörter unterstreichen. Das Rich-Edit-Steuerelement zeigt den Text mit einer einfarbigen Unterstreichung an.

bAnimation

Typ: BYTE-

Textanimationstyp. Dieser Wert hat keine Auswirkungen auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird; sie ist zur Kompatibilität mit TOM-Schnittstellen enthalten. Um dieses Element zu verwenden, legen Sie das CFM_ANIMATION Flag im dwMask Member fest.

bRevAuthor

Typ: BYTE-

Ein Index, der den Autor identifiziert, der eine Überarbeitung vornimmt. Das Rich-Edit-Steuerelement verwendet unterschiedliche Textfarben für jeden verschiedenen Autorenindex. Um dieses Element zu verwenden, legen Sie das CFM_REVAUTHOR Flag im dwMask--Element fest.

bUnderlineColor

Typ: BYTE-

Unterstreichungsfarbe:

  • UnderlineColor_Black = 0x00;
  • UnderlineColor_Blue = 0x01;
  • UnderlineColor_Aqua = 0x02;
  • UnderlineColor_Lime = 0x03;
  • UnderlineColor_Fuchsia = 0x04;
  • UnderlineColor_Red = 0x05;
  • UnderlineColor_Yellow = 0x06;
  • UnderlineColor_White = 0x07;
  • UnderlineColor_Navy = 0x08;
  • UnderlineColor_Teal = 0x09;
  • UnderlineColor_Green = 0x0A;
  • UnderlineColor_Purple = 0x0B;
  • UnderlineColor_Maroon = 0x0C;
  • UnderlineColor_Olive = 0x0D;
  • UnderlineColor_DkGray = 0x0E;
  • UnderlineColor_LtGray = 0x0F;

Bemerkungen

Um ein Formatierungsattribut zu deaktivieren, legen Sie den entsprechenden Wert in dwMask- fest, legen aber nicht den entsprechenden Wert in dwEffectsfest. Wenn Sie z. B. Kursiv deaktivieren möchten, legen Sie CFM_ITALIC fest, legen sie jedoch nicht CFE_ITALICfest.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- richedit.h

Siehe auch

CHARFORMAT-

COLORREF-

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

GetSysColor-

LOGFONT-

RGB-