CHARFORMAT2A-Struktur (Rich Edit 2.0)
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
typedef struct _charformat2a {
UINT cbSize;
DWORD dwMask;
DWORD dwEffects;
LONG yHeight;
LONG yOffset;
COLORREF crTextColor;
BYTE bCharSet;
BYTE bPitchAndFamily;
char szFaceName[LF_FACESIZE];
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;
} CHARFORMAT2A;
Member
cbSize
Typ: UINT
Gibt die Größe (in Bytes) der Struktur an. Bevor Sie diese Struktur an ein Rich-Edit-Steuerelement übergeben, legen Sie cbSize auf die Größe der CHARFORMAT - oder CHARFORMAT2-Struktur fest. Wenn cbSize der Größe einer CHARFORMAT-Struktur entspricht, verwendet das Steuerelement nur die CHARFORMAT-Member .
dwMask
Typ: DWORD
Gibt die Teile der CHARFORMAT2-Struktur an, die gültige Informationen enthalten. Das dwMask-Element kann eine Kombination der Werte aus zwei Sätzen von Bitflags sein. Ein Satz gibt die gültigen Strukturmember an. Ein weiterer Satz gibt die gültigen Attribute im dwEffects-Element an.
Legen Sie die folgenden Werte fest, um die gültigen Attribute des dwEffects-Elements anzugeben.
Legen Sie die folgenden Werte fest, um die gültigen Strukturmember anzugeben.
dwEffects
Typ: DWORD
Eine Reihe von Bitflags, die Zeicheneffekte angeben. Einige der Flags sind nur aus Gründen der Kompatibilität mit Microsoft Text Object Model (TOM)-Schnittstellen enthalten. das Rich-Edit-Steuerelement speichert den Wert, aber nicht zum Anzeigen von Text.
Dieser Member kann eine Kombination der folgenden Werte sein.
Wert | Bedeutung |
---|---|
|
Zeichen sind alle Großbuchstaben. Der Wert wirkt sich nicht auf die Art und Weise aus, wie das Steuerelement den Text anzeigt. Dieser Wert gilt nur für Versionen vor Microsoft Rich Edit 3.0. |
|
Die Hintergrundfarbe ist der Rückgabewert von GetSysColor(COLOR_WINDOW). Wenn dieses Flag festgelegt ist, wird das crBackColor-Element ignoriert. |
|
Die Textfarbe ist der Rückgabewert von GetSysColor(COLOR_WINDOWTEXT). Wenn dieses Flag festgelegt ist, wird das element crTextColor ignoriert. |
|
Zeichen sind fett formatiert. |
|
Zeichen werden mit einem Schatten angezeigt, der um 3/4 Punkt oder ein Pixel versetzt wird, je nachdem, welcher Wert größer ist. |
|
Zeichen werden geprägt. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt. |
|
Die Zeichen sind weniger häufige Elemente eines Skripts. Eine Schriftart, die ein Skript unterstützt, sollte überprüfen, ob sie über Glyphen für solche Zeichen verfügt. |
|
Schriftart wird vom Rich-Edit-Steuerelement ausgewählt, da die aktive Schriftart die Zeichen nicht unterstützt. Dieser Prozess wird als Schriftbindung bezeichnet. |
|
Bei Microsoft Rich Edit 3.0 und höher werden keine Zeichen angezeigt. |
|
Zeichen werden als geprägte Zeichen angezeigt. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt. |
|
Zeichen sind kursiv. |
|
Ein Rich-Edit-Steuerelement kann EN_LINK Benachrichtigungscodes senden, wenn es Mausnachrichten empfängt, während sich der Mauszeiger über Text mit dem CFE_LINK Effekt befindet. |
|
Zeichen sind Teil eines Anzeigenamenlinks. |
|
Zeichen befinden sich in einer Mathematischen Zone. |
|
Zeichen nehmen nicht an einem Mathematischen Aufbau teil. Wenn sie beispielsweise auf ein /angewendet wird, wird das / nicht verwendet, um einen Bruchteil zu erstellen. |
|
Zeichen werden als gewöhnlicher Text innerhalb einer Mathematischen Zone angezeigt. |
|
Zeichen werden als umrissene Zeichen angezeigt. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt. |
|
Zeichen sind geschützt; Ein Versuch, sie zu ändern, führt zu einem EN_PROTECTED Benachrichtigungscode. |
|
Zeichen werden als überarbeitet markiert. |
|
Zeichen werden als Schattenzeichen angezeigt. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt. |
|
Zeichen sind in kleinen Großbuchstaben. Der Wert wirkt sich nicht darauf aus, wie das Steuerelement den Text anzeigt. |
|
Zeichen werden ausgeschlagen. |
|
Zeichen sind tiefgestellt. Die werte CFE_SUPERSCRIPT und CFE_SUBSCRIPT schließen sich gegenseitig aus. Für beide Werte berechnet das Steuerelement automatisch einen Offset und einen kleineren Schriftgrad. Alternativ können Sie die Elemente yHeight und yOffset verwenden, um die Schriftgröße und den Offset für tief- und hochgestellte Zeichen explizit anzugeben. |
|
Zeichen sind hochgestellt. |
|
Zeichen werden unterstrichen. |
yHeight
Typ: LONG
Gibt die Zeichenhöhe in Twips (1/1440 eines Zolls oder 1/20 des Druckerpunkts) an. Um dieses Element zu verwenden, legen Sie das flag CFM_SIZE im dwMask-Element fest.
yOffset
Typ: LONG
Zeichenoffset aus der Baseline in Twips. Wenn der Wert dieses Elements positiv ist, ist das Zeichen ein hochgestelltes Zeichen. wenn der Wert negativ ist, ist das Zeichen ein Tiefpunkt. Um dieses Element zu verwenden, legen Sie das CFM_OFFSET-Flag im dwMask-Element fest.
crTextColor
Typ: COLORREF
Textfarbe. Um dieses Element zu verwenden, legen Sie das CFM_COLOR-Flag im dwMask-Element fest. Dieses Element wird ignoriert, wenn der CFE_AUTOCOLOR Zeicheneffekt angegeben wird. Um ein COLORREF zu generieren, verwenden Sie das RGB-Makro .
bCharSet
Typ: BYTE
Zeichensatzwert. Dies kann einer der Werte sein, die für das lfCharSet-Element der LOGFONT-Struktur angegeben sind. Um dieses Element zu verwenden, legen Sie das CFM_CHARSET-Flag im dwMask-Element fest.
bPitchAndFamily
Typ: BYTE
Gibt die Schriftfamilie und die Tonhöhe an. Dieses Element ist identisch mit dem lfPitchAndFamily-Member der LOGFONT-Struktur .
szFaceName[LF_FACESIZE]
Typ: TCHAR[LF_FACESIZE]
Ein Zeichenarray mit NULL-Beendigung, das den Namen der Schriftart angibt. Um dieses Element zu verwenden, legen Sie das flag CFM_FACE im dwMask-Element fest.
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 |
---|---|
|
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). |
|
Fälschen Sie für die IME-Komposition eine Auswahl. |
|
Text unterstrichen mit einer einzelnen durchgehenden Zeile. |
|
Text unterstrichen mit Bindestrichen. |
|
Text unterstrichen mit einer gestrichelten und gepunkteten Linie. |
|
Text unterstrichen mit gestrichelter und doppelt gepunkteter Linie. |
|
Text unterstrichen mit einer gepunkteten Linie. Bei Versionen vor Microsoft Rich Edit 3.0 wird Text mit einer durchgehenden Unterstreichung angezeigt. |
|
Text unterstrichen mit einer doppelten Zeile. Das Rich-Edit-Steuerelement zeigt den Text mit einer vollfarbigen Unterstreichung an. |
|
Wird als CFU_UNDERLINEWAVE angezeigt. |
|
Wird als CFU_UNDERLINE angezeigt. |
|
Wird als CFU_UNDERLINEWAVE angezeigt. |
|
Wird als CFU_UNDERLINEDASH angezeigt. |
|
Keine Unterstreichung. Dies ist die Standardoption. |
|
Wird als CFU_UNDERLINE angezeigt. |
|
Wird als CFU_UNDERLINEDASH angezeigt. |
|
Wird als CFU_UNDERLINEDASHDOT angezeigt. |
|
Wird als CFU_UNDERLINEDASHDOT angezeigt. |
|
Wird als CFU_UNDERLINEDOT angezeigt. |
|
Wird als CFU_UNDERLINEDASH angezeigt. |
|
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 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
Unterstrichsfarbe:
- 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.
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 |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für