CHARFORMAT2

[Dies ist vorläufige Dokumentation und Änderungenvorbehalten.]

Die CHARFORMAT2 -Struktur enthält Informationen über die Zeichenformatierung in einem rich-Edit-Steuerelement. CHARFORMAT2 ist ein rich-Edit-2.0-Erweiterung der CHARFORMAT Struktur. Rich-Edit-2.0 können Sie entweder Struktur mit EM_GETCHARFORMAT und EM_SETCHARFORMAT Nachrichten.

typedef Struct _charformat2 {}
    UINT CbSize;
    _WPAD _wPad1;
    DWORD DwMask;
    DWORD DwEffects;
    LONG yHeight;
    LANGE yOffset;
    COLORREF CrTextColor;
    BYTE bCharSet;
    BYTE bPitchAndFamily;
    WCHAR SzFaceName [LF_FACESIZE];
    _WPAD _wPad2;
    WORD wWeight;
    KURZE sSpacing;
    COLORREF CrBackColor;
    LCID Lcid;
    DWORD DwReserved;
    KURZE sStyle;
    WORD wKerning;
    BYTE bUnderlineType;
    BYTE bAnimation;
    BYTE bRevAuthor;
    BYTE bReserved1;
} CHARFORMAT2 

Mitglieder

cbSize
Gibt die Größe in Bytes, der Struktur. Legen Sie bevor diese Struktur an ein rich-Edit-Steuerelement übergeben CbSize auf die Größe der Struktur ZEICHENFORMAT oder CHARFORMAT2 . Wenn CbSize die Größe einer CHARFORMAT -Struktur entspricht, verwendet das Steuerelement nur die CHARFORMAT -Member.
dwMask
Gibt die Teile der CHARFORMAT2 -Struktur, die gültigen Informationen enthalten. Das DwMask -Mitglied kann eine Kombination der Werte von zwei Sätze von Bitflags. Ein Satz gibt die Strukturmember, die gültig sind. Eine andere Gruppe zeigt die gültigen Attribute in der DwEffects -member.

Legen Sie die folgenden Werte an die gültige Struktur-Member.
Wert Bedeutung
CFM_ANIMATION Das bAnimation -Element ist gültig.
CFM_BACKCOLOR Das CrBackColor -Element ist gültig.
CFM_CHARSET Das bCharSet -Element ist gültig.
CFM_COLOR Das CrTextColor -Element ist gültig, wenn das CFE_AUTOCOLOR-Flag, in den DwEffects festgelegt ist.
CFM_FACE Das SzFaceName -Element ist gültig.
CFM_KERNING Das wKerning -Element ist gültig.
CFM_LCID Das Lcid -Element ist gültig.
CFM_OFFSET Das yOffset Mitglied ist gültig.
CFM_REVAUTHOR Das bRevAuthor -Element ist gültig.
CFM_SIZE Das yHeight Mitglied ist gültig.
CFM_SPACING Das sSpacing -Element ist gültig.
CFM_STYLE Das sStyle Mitglied ist gültig.
CFM_UNDERLINETYPE Das bUnderlineType -Element ist gültig.
CFM_WEIGHT Das wWeight -Element ist gültig.

Legen Sie die folgenden Werte an die gültigen Attribute des betreffenden dwEffects:
Wert Bedeutung
CFM_ALLCAPS Der Wert CFE_ALLCAPS ist gültig.
CFM_BOLD Der Wert CFE_BOLD ist gültig.
CFM_COLOR Der CFE_AUTOCOLOR-Wert ist ungültig, oder das CrTextColor -Element ist gültig.
CFM_DISABLED Der Wert CFE_DISABLED ist gültig.
CFM_EMBOSS Der Wert CFE_EMBOSS ist gültig.
CFM_HIDDEN Der Wert CFE_HIDDEN ist gültig.
CFM_IMPRINT Der Wert CFE_IMPRINT ist gültig.
CFM_ITALIC Der Wert CFE_ITALIC ist gültig.
CFM_LINK Der Wert CFE_LINK ist gültig.
CFM_OUTLINE Der Wert CFE_OUTLINE ist gültig.
CFM_PROTECTED Der Wert CFE_PROTECTED ist gültig.
CFM_REVISED Der Wert CFE_REVISION ist gültig.
CFM_SHADOW Der Wert CFE_SHADOW ist gültig.
CFM_SMALLCAPS Der Wert CFE_SMALLCAPS ist gültig.
CFM_STRIKEOUT Der Wert CFE_STRIKEOUT ist gültig.
CFM_SUBSCRIPT Die Werte CFE_SUBSCRIPT und CFE_SUPERSCRIPT sind gültig.
CFM_SUPERSCRIPT Identisch CFM_SUBSCRIPT.
CFM_UNDERLINE. Der Wert CFE_UNDERLINE ist gültig.

dwEffects
Ein Satz von Bitflags, die angeben, Zeicheneffekte. Einige der Flaggen sind nur für Kompatibilität mit Microsoft Text Objekt Model (TOM) Schnittstellen enthalten; das rich-Edit-Steuerelement speichert den Wert aber nicht zum Anzeigen von Text verwendet.

Dieses Mitglied kann eine Kombination der folgenden Werte sein.
Wert Bedeutung
CFE_ALLCAPS Zeichen sind Großbuchstaben. Den Weg berührt nicht, den das Steuerelement Text anzeigt.
CFE_AUTOCOLOR Die Farbe des Textes ist der Rückgabewert von GetSysColor (COLOR_WINDOWTEXT). Wenn dieses Flag festgelegt ist, wird das CrTextColor -Element ignoriert.
CFE_BOLD Zeichen sind fett gedruckt.
CFE_DELETED Die Zeichen markiert als gelöscht.
CFE_EMBOSS Zeichen geprägt sind. Wirkt nicht, wie das Steuerelement zeigt den text.
CFE_HIDDEN Zeichen werden nicht angezeigt. Wirkt nicht, wie das Steuerelement zeigt den text.
CFE_IMPRINT Zeichen werden als aufgedruckten Zeichen angezeigt. Wirkt nicht, wie das Steuerelement zeigt den text.
CFE_ITALIC Zeichen sind kursiv.
CFE_LINK Ein rich-Edit-Steuerelement kann EN_LINK -Benachrichtigungen senden, wenn sie Maus Nachrichten empfängt, während der Mauszeiger über den Text mit der CFE_LINK Wirkung ist.
CFE_OUTLINE Zeichen werden als gegliederten Zeichen angezeigt. Wirkt nicht, wie das Steuerelement zeigt den text.
CFE_PROTECTED Zeichen geschützt werden; ein Versuch, sie zu ändern verursacht eine EN_PROTECTED -Benachrichtigung.
CFE_REVISION Markiert die Zeichen als überarbeitete.
CFE_SHADOW Zeichen werden als gespiegelte Zeichen angezeigt. Wirkt nicht, wie das Steuerelement zeigt den text.
CFE_SMALLCAPS Zeichen werden in Kapitälchen. Wirkt nicht, wie das Steuerelement zeigt den text.
CFE_STRIKEOUT Zeichen fällt aus.
CFE_SUBSCRIPT Zeichen werden hochgestellt. Die Werte CFE_SUPERSCRIPT und CFE_SUBSCRIPT schließen sich gegenseitig aus. Für beide Werte berechnet das Steuerelement automatisch ein Offset und eine kleinere Schriftgröße. Alternativ können Sie die yHeight und yOffset Member explizit angeben, Schriftgröße und der Offset für hoch- und tiefgestellte Zeichen.
CFE_SUPERSCRIPT Zeichen werden hochgestellt.
CFE_UNDERLINE Zeichen unterstrichen.

yHeight
Die Zeichenhöhe angibt in Twips. Ein Twip ist 1/1440 Zoll oder 1/20 Punkt eines Druckers. Um dieses Element zu verwenden, legen Sie das CFM_SIZE-Flag im DwMask -member.
yOffset
Gibt den Zeichenoffset in Twips, von der Basislinie. Wenn dieser Member positiv ist, ist das Zeichen hochgestellt; Wenn es negativ ist, ist das Zeichen eine Tiefstellung. Um dieses Element zu verwenden, legen Sie das CFM_OFFSET-Flag im DwMask -member.
crTextColor
Gibt die Farbe des Textes. Um dieses Element zu verwenden, legen Sie das CFM_COLOR-Flag im DwMask -Member. Dieser Member wird ignoriert, wenn die Wirkung CFE_AUTOCOLOR Zeichen angegeben ist.
bCharSet
Gibt den Zeichensatz-Wert, der die Werte für den LfCharSet Member angegeben werden, kann die LOGFONT -Struktur. Um dieses Element zu verwenden, legen Sie das CFM_CHARSET-Flag im DwMask -member.
bPitchAndFamily
Gibt die Schriftfamilie und Tonhöhe. Dieser Member ist dasselbe als LfPitchAndFamily Mitglied die LOGFONT -Struktur.
szFaceName
Eine Null-terminierte Zeichenarray angeben den Namen der Schriftart Gesicht. Um dieses Element zu verwenden, legen Sie das CFM_FACE-Flag im DwMask -member.
wWeight
Gibt die Schriftbreite. Dieser Member ist das gleiche wie das LfWeight Mitglied die LOGFONT -Struktur. Um dieses Element zu verwenden, legen Sie das CFM_WEIGHT-Flag im DwMask -member.
sSpacing
Gibt den horizontalen Abstand, der in Twips zwischen den Buchstaben. Dieser Wert hat keine Auswirkungen auf den von einem rich-Edit-Steuerelement angezeigten Text; Es dient zur Kompatibilität mit Microsoft Text Objekt Model (TOM) Schnittstellen. Um dieses Element zu verwenden, legen Sie das CFM_SPACING-Flag im DwMask -member.
crBackColor
Gibt die Hintergrundfarbe. Um dieses Element zu verwenden, legen Sie das CFM_BACKCOLOR-Flag im DwMask -member.
lcid
Gibt einen 32-Bit-Gebietsschemabezeichner, der eine Sprachen-ID in das untere Wort, und eine Sortierung Bezeichner und reservierter Wert im oberen Wort enthält. Dieses Mitglied hat keinen Einfluss auf den von einem rich-Edit-Steuerelement angezeigten Text, aber Rechtschreib- und Grammatikprüfung können sie sprachabhängige Probleme bewältigen. Sie können die MAKELCID Makro, das einen LCID-Wert erstellen. Um dieses Element zu verwenden, legen Sie das CFM_LCID-Flag im DwMask -member.
dwReserved
Vorbehalten; NULL muss sein.
sStyle
Gibt einen Handle an Stil. Dieser Wert hat keine Auswirkungen auf den von einem rich-Edit-Steuerelement angezeigten Text; Es dient zur Kompatibilität mit Microsoft Text Objekt Model (TOM) Schnittstellen. Um dieses Element zu verwenden, legen Sie das CFM_STYLE-Flag im DwMask -member.
wKerning
Gibt die Größe der Twip oben, um das Zeichen kern. Dieser Wert hat keine Auswirkungen auf den von einem rich-Edit-Steuerelement angezeigten Text; Es dient zur Kompatibilität mit TOM Schnittstellen. Um dieses Element zu verwenden, legen Sie das CFM_KERNING-Flag im DwMask -member.
bUnderlineType
Gibt den Typ unterstreichen. Um dieses Element zu verwenden, legen Sie das CFM_UNDERLINETYPE-Flag im DwMask -Member. Dieses Mitglied kann einer der folgenden Werte sein.
Wert Bedeutung
CFU_CF1UNDERLINE CHARFORMAT2 CHARFORMATBit Unterstreichung zuordnen.
CFU_INVERT IME-Komposition gefälschte eine Auswahl.
CFU_UNDERLINE Solide unterstreichen.
CFU_UNDERLINEDOTTED Punktiert unterstrichen. Das rich-Edit-Steuerelement zeigt den Text mit einer festen unterstrichen.
CFU_UNDERLINEDOUBLE Doppelt unterstrichen Text. Das rich-Edit-Steuerelement zeigt den Text mit einer festen unterstrichen.
CFU_UNDERLINENONE Keine Unterstreichung. Dies ist die Standardeinstellung.
CFU_UNDERLINEWORD Unterstreichen Sie nur Wörter. Das rich-Edit-Steuerelement zeigt den Text mit einer festen unterstrichen.

bAnimation
Gibt an, das die modifizierte Textanimation. Dieser Wert hat keine Auswirkungen auf den von einem rich-Edit-Steuerelement angezeigten Text; Es dient zur Kompatibilität mit TOM Schnittstellen. Um dieses Element zu verwenden, legen Sie das CFM_ANIMATION-Flag im DwMask -member.
bRevAuthor
Gibt einen Index, der den Autor machen eine Überarbeitung identifiziert. Das rich-Edit-Steuerelement verwendet verschiedene Textfarben für jeden anderen Autorenindex. Um dieses Element zu verwenden, legen Sie das CFM_REVAUTHOR-Flag im DwMask -member.
bReserved1
Vorbehalten; NULL muss sein.

QuickInfo

&Nbsp; Windows NT: Version 4.0 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:Deklariert in richedit.h.
Unicode:Als Unicode und ANSI Strukturen definiert.

Siehe auch

Rich-Edit-Steuerelemente (Übersicht), Rich-Edit-Strukturen, ZEICHENFORMAT, EM_GETCHARFORMAT, EM_SETCHARFORMAT, EN_PROTECTED, GetSysColor, LOGFONT, MAKELCID

Index