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 |
|---|---|
|
Die Struktur ordnet CHARFORMATBit-Unterstreichung CHARFORMAT2zu (d. a. es führt eine CHARFORMAT- Art der Unterstreichung in diesem Text aus). |
|
Für DIE IME-Komposition fälschen Sie eine Auswahl. |
|
Text unterstrichen mit einer einzelnen einfarbigen Linie. |
|
Text unterstrichen mit Bindestrichen. |
|
Text unterstrichen mit gestrichelter und gepunkteter Linie. |
|
Text unterstrichen mit gestrichelter und doppelter gepunkteter Linie. |
|
Text unterstrichen mit einer gepunkteten Linie. Für Versionen vor Microsoft Rich Edit 3.0 wird Text mit einer einfarbigen Unterstreichung angezeigt. |
|
Text unterstrichen mit einer doppelzeiligen Linie. Das Rich-Edit-Steuerelement zeigt den Text mit einer einfarbigen Unterstreichung an. |
|
Als CFU_UNDERLINEWAVEanzeigen. |
|
Als CFU_UNDERLINEanzeigen . |
|
Als CFU_UNDERLINEWAVEanzeigen. |
|
Als CFU_UNDERLINEDASHanzeigen . |
|
Keine Unterstreichung. Dies ist die Standardeinstellung. |
|
Als CFU_UNDERLINEanzeigen . |
|
Als CFU_UNDERLINEDASHanzeigen . |
|
Als CFU_UNDERLINEDASHDOTanzeigen. |
|
Als CFU_UNDERLINEDASHDOTanzeigen. |
|
Als CFU_UNDERLINEDOTanzeigen . |
|
Als CFU_UNDERLINEDASHanzeigen . |
|
RichEdit 4.1 und höher: Text unterstrichen mit einer wellenförmigen Linie. |
|
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 |