CHARFORMATW-Struktur (richedit.h)

Artikel
05/25/2023

Enthält Informationen zur Zeichenformatierung in einem Rich-Edit-Steuerelement.

Rich Edit 2.0: Die CHARFORMAT2-Struktur ist eine Microsoft Rich Edit 2.0-Erweiterung der CHARFORMAT-Struktur . Mit Microsoft Rich Edit 2.0 und höher können Sie beide Strukturen mit den EM_GETCHARFORMAT und EM_SETCHARFORMAT Nachrichten verwenden.

Syntax

typedef struct _charformatw {
  UINT     cbSize;
  DWORD    dwMask;
  DWORD    dwEffects;
  LONG     yHeight;
  LONG     yOffset;
  COLORREF crTextColor;
  BYTE     bCharSet;
  BYTE     bPitchAndFamily;
  WCHAR    szFaceName[LF_FACESIZE];
} CHARFORMATW;

Member

cbSize

Typ: UINT

Größe in Bytes der angegebenen Struktur. Dieses Element muss festgelegt werden, bevor die Struktur an das Rich-Bearbeitungssteuerelement übergeben wird.

dwMask

Typ: DWORD

Member, die gültige Informationen oder Attribute enthalten, die festgelegt werden sollen. Dieser Member kann null, 1 oder mehr als einer der folgenden Werte sein.

Wert	Bedeutung
CFM_ALL	Windows 8: Eine Kombination der folgenden Werte: CFM_EFFECTS \| CFM_SIZE \| CFM_FACE \| CFM_OFFSET \| CFM_CHARSET
CFM_BOLD	Der CFE_BOLD Wert des dwEffects-Elements ist gültig.
CFM_CHARSET	Das bCharSet-Element ist gültig.
CFM_COLOR	Das crTextColor-Element und der CFE_AUTOCOLOR-Wert des dwEffects-Members sind gültig.
CFM_EFFECTS	Windows 8: Eine Kombination der folgenden Werte: CFM_BOLD \| CFM_ITALIC \| CFM_UNDERLINE \| CFM_COLOR \| CFM_STRIKEOUT \| CFE_PROTECTED \| CFM_LINK
CFM_FACE	Das szFaceName-Element ist gültig.
CFM_ITALIC	Der CFE_ITALIC Wert des dwEffects-Elements ist gültig.
CFM_OFFSET	Das yOffset-Element ist gültig.
CFM_PROTECTED	Der CFE_PROTECTED Wert des dwEffects-Elements ist gültig.
CFM_SIZE	Das yHeight-Element ist gültig.
CFM_STRIKEOUT	Der CFE_STRIKEOUT Wert des dwEffects-Elements ist gültig.
CFM_UNDERLINE	Der CFE_UNDERLINE Wert des dwEffects-Elements ist gültig.

dwEffects

Typ: DWORD

Zeicheneffekte. Dieser Member kann eine Kombination der folgenden Werte sein.

Wert	Bedeutung
CFE_AUTOCOLOR	Die Textfarbe ist der Rückgabewert von GetSysColor(COLOR_WINDOWTEXT).
CFE_BOLD	Zeichen sind fett formatiert.
CFE_DISABLED	RichEdit 2.0 und höher: Zeichen werden mit einem Schatten angezeigt, der um 3/4 Punkt oder ein Pixel versetzt wird, je nachdem, welcher Wert größer ist.
CFE_ITALIC	Zeichen sind kursiv.
CFE_STRIKEOUT	Zeichen werden angeschlagen.
CFE_UNDERLINE	Zeichen werden unterstrichen.
CFE_PROTECTED	Zeichen sind geschützt; Ein Versuch, sie zu ändern, führt zu einem EN_PROTECTED Benachrichtigungscode.

yHeight

Typ: LONG

Zeichenhöhe in Twips (1/1440 eines Zolls oder 1/20 des Druckerpunkts).

yOffset

Typ: LONG

Zeichenoffset in Twips aus der Baseline. Wenn der Wert dieses Elements positiv ist, ist das Zeichen ein hochgestelltes Zeichen. wenn es negativ ist, ist das Zeichen ein Tiefpunkt.

crTextColor

Typ: COLORREF

Textfarbe. 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. Das bCharSet-Element kann einer der Werte sein, die für das lfCharSet-Element der LOGFONT-Struktur angegeben sind. Microsoft Rich Edit 3.0 überschreibt diesen Wert möglicherweise, wenn er für die Zielzeichen ungültig ist.

bPitchAndFamily

Typ: BYTE

Schriftfamilie und Tonhöhe. Dieses Element ist identisch mit dem lfPitchAndFamily-Member der LOGFONT-Struktur .

szFaceName[LF_FACESIZE]

Typ: TCHAR[LF_FACESIZE]

Null-endendes Zeichenarray, das den Schriftnamen angibt.

Hinweise

Um ein Formatierungsattribut zu deaktivieren, legen Sie den entsprechenden Wert in dwMask fest, aber nicht den entsprechenden Wert in dwEffects. Um beispielsweise kursiv zu deaktivieren, legen Sie CFM_ITALIC fest, aber nicht CFE_ITALIC.

Hinweis

Der richedit.h-Header definiert CHARFORMAT 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	richedit.h

Weitere Informationen

Referenz

Share via