CHARFORMAT2W-Struktur (richedit.h)

Artikel
03/08/2023

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

Syntax

struct CHARFORMAT2W : _charformatw {
  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;
};

Vererbung

Die CHARFORMAT2W-Struktur implementiert _charformatw.

Member

wWeight

Typ: WORD

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

sSpacing

Typ: SHORT

Horizontaler Abstand zwischen Buchstaben in Twips. Dieser Wert hat keine Auswirkung auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird. es ist aus Gründen der Kompatibilität mit Windows TOM-Schnittstellen enthalten. Um dieses Element zu verwenden, legen Sie das flag CFM_SPACING im dwMask-Element fest.

crBackColor

Typ: COLORREF

Hintergrundfarbe. Um dieses Element zu verwenden, legen Sie das flag CFM_BACKCOLOR im dwMask-Element fest. Dieser Member wird ignoriert, wenn der CFE_AUTOBACKCOLOR Zeicheneffekt angegeben wird. Verwenden Sie das Makro, um einen 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. Dieser Member hat keine Auswirkungen auf den Text, der von einem umfangreichen Bearbeitungssteuerelement angezeigt wird, aber Rechtschreib- und Grammatikprüfung kann es 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 flag CFM_LCID im dwMask-Element fest.

dwReserved

Typ: DWORD

Reserviert; der Wert muss 0 (null) sein.

Typ: DWORD

Reserviert; der Wert muss 0 (null) sein.

dwCookie

Typ: DWORD

Clientcookies. Dieses Element ist für ein umfangreiches Bearbeitungssteuerelement undurchsichtig.

sStyle

Typ: SHORT

Zeichenformathandle. Dieser Wert hat keine Auswirkung auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird. Es ist aus Gründen der Kompatibilität mit WindowsTOM-Schnittstellen enthalten. Um dieses Element zu verwenden, legen Sie das flag CFM_STYLE im dwMask-Element fest. Weitere Informationen finden Sie in der TOM-Dokumentation.

wKerning

Typ: WORD

Wert des Schriftgrads, über dem das Zeichen eingeschlossen werden soll (yHeight). Dieser Wert hat keine Auswirkung auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird. es ist aus Gründen der Kompatibilität mit TOM-Schnittstellen enthalten. Um dieses Element zu verwenden, legen Sie das flag CFM_KERNING im dwMask-Element fest.

bUnderlineType

Typ: BYTE

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

Wert	Bedeutung
CFU_CF1UNDERLINE	Die -Struktur ordnet die Bit-Unterstriche von CHARFORMATCHARFORMAT2 zu (das heißt, sie führt einen CHARFORMAT-Typ der Unterstreichung für diesen Text aus).
CFU_INVERT	Fälschen Sie für die IME-Komposition eine Auswahl.
CFU_UNDERLINE	Text unterstrichen mit einer einzelnen durchgehenden Zeile.
CFU_UNDERLINEDASH	Text unterstrichen mit Bindestrichen.
CFU_UNDERLINEDASHDOT	Text unterstrichen mit einer gestrichelten und gepunkteten Linie.
CFU_UNDERLINEDASHDOTDOT	Text unterstrichen mit gestrichelter und doppelt gepunkteter Linie.
CFU_UNDERLINEDOTTED	Text unterstrichen mit einer gepunkteten Linie. Bei Versionen vor Microsoft Rich Edit 3.0 wird Text mit einer durchgehenden Unterstreichung angezeigt.
CFU_UNDERLINEDOUBLE	Text unterstrichen mit einer doppelten Zeile. Das Rich-Edit-Steuerelement zeigt den Text mit einer vollfarbigen Unterstreichung an.
CFU_UNDERLINEDOUBLEWAVE	Wird als CFU_UNDERLINEWAVE angezeigt.
CFU_UNDERLINEHAIRLINE	Wird als CFU_UNDERLINE angezeigt.
CFU_UNDERLINEHEAVYWAVE	Wird als CFU_UNDERLINEWAVE angezeigt.
CFU_UNDERLINELONGDASH	Wird als CFU_UNDERLINEDASH angezeigt.
CFU_UNDERLINENONE	Keine Unterstreichung. Dies ist die Standardoption.
CFU_UNDERLINETHICK	Wird als CFU_UNDERLINE angezeigt.
CFU_UNDERLINETHICKDASH	Wird als CFU_UNDERLINEDASH angezeigt.
CFU_UNDERLINETHICKDASHDOT	Wird als CFU_UNDERLINEDASHDOT angezeigt.
CFU_UNDERLINETHICKDASHDOTDOT	Wird als CFU_UNDERLINEDASHDOT angezeigt.
CFU_UNDERLINETHICKDOTTED	Wird als CFU_UNDERLINEDOT angezeigt.
CFU_UNDERLINETHICKLONGDASH	Wird als CFU_UNDERLINEDASH angezeigt.
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 vollfarbigen Unterstreichung an.

bAnimation

Typ: BYTE

Textanimationstyp. Dieser Wert hat keine Auswirkung auf den Text, der von einem Rich-Edit-Steuerelement angezeigt wird. es ist aus Gründen der Kompatibilität mit TOM-Schnittstellen enthalten. Um dieses Element zu verwenden, legen Sie das flag CFM_ANIMATION im dwMask-Element 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 flag CFM_REVAUTHOR 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;

Hinweise

Um ein Formatierungsattribut zu deaktivieren, legen Sie den entsprechenden Wert in dwMask fest, aber nicht den entsprechenden Wert in dwEffects. Um z. B. kursiv zu deaktivieren, legen Sie CFM_ITALIC fest, aber nicht CFE_ITALIC.

Hinweis

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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	richedit.h