Auf Englisch lesen

Freigeben über


CHARFORMAT2W Struktur (richedit.h)

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

Erbschaft

Die CHARFORMAT2W-Struktur implementiert _charformatw.

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.

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.

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