CHARFORMAT2A Struktur (richedit.h)

Artikel
08/15/2024

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

struct CHARFORMAT2A : _charformat {
  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;
};

Erbschaft

Die CHARFORMAT2A-Struktur implementiert _charformat.

Angehörige

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.

Anmerkung

Der Richedit.h-Header definiert CHARFORMAT2 als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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