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

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

Siehe auch

CHARFORMAT-

COLORREF-

EM_GETCHARFORMAT

EM_SETCHARFORMAT

EN_PROTECTED

GetSysColor-

LOGFONT-

RGB-