EM_SETCHARFORMAT Nachricht

Legt die Zeichenformatierung in einem Rich-Edit-Steuerelement fest.

Parameter

wParam

Zeichenformatierung, die für das Steuerelement gilt. Wenn dieser Parameter 0 ist, wird das Standardzeichenformat festgelegt. Andernfalls kann es sich um einen der folgenden Werte handeln.

Wert	Bedeutung
SCF_ALL	Wendet die Formatierung auf den gesamten Text im Steuerelement an. Ungültig mit SCF_SELECTION oder SCF_WORD.
SCF_ASSOCIATEFONT	RichEdit 4.1: Ordnet eine Schriftart einem bestimmten Skript zu, wodurch die Standardschriftart für dieses Skript geändert wird. Verwenden Sie zum Angeben der Schriftart die folgenden Elemente von CHARFORMAT2: yHeight, bCharSet, bPitchAndFamily, szFaceName und lcid.
SCF_ASSOCIATEFONT2	RichEdit 4.1: Ordnet eine Ersatzschriftart (Ebene-2) einem bestimmten Skript zu, wodurch die Standardschriftart für dieses Skript geändert wird. Verwenden Sie zum Angeben der Schriftart die folgenden Elemente von CHARFORMAT2: yHeight, bCharSet, bPitchAndFamily, szFaceName und lcid.
SCF_CHARREPFROMLCID	Ruft das Charakterrepertoire aus dem LCID ab.
SCF_DEFAULT	RichEdit 4.1: Legt die Standardschriftart für das Steuerelement fest.
SPF_DONTSETDEFAULT	Verhindert das Festlegen des Standardabsatzformats, wenn das Rich-Edit-Steuerelement leer ist.
SCF_NOKBUPDATE	RichEdit 4.1: Verhindert, dass die Tastatur so wechselt, dass sie der Schriftart entspricht. Wenn beispielsweise eine arabische Schriftart festgelegt ist, ändert normalerweise die automatische Tastaturfunktion für Bidi-Sprachen die Tastatur in eine arabische Tastatur.
SCF_SELECTION	Wendet die Formatierung auf die aktuelle Auswahl an. Wenn die Auswahl leer ist, wird die Zeichenformatierung auf die Einfügemarke angewendet, und das neue Zeichenformat ist nur wirksam, bis sich die Einfügemarke ändert.
SPF_SETDEFAULT	Legt die Standardattribute für die Absatzformatierung fest.
SCF_SMARTFONT	Wenden Sie die Schriftart nur an, wenn sie Skripts verarbeiten kann.
SCF_USEUIRULES	RichEdit 4.1: Wird mit SCF_SELECTION verwendet. Gibt an, dass das Format von einer Symbolleiste oder einem anderen Ui-Tool stammt. Daher sollten anstelle der Literalformatierung Regeln für die UI-Formatierung verwendet werden.
SCF_WORD	Wendet die Formatierung auf das ausgewählte Wort oder die ausgewählten Wörter an. Wenn die Auswahl leer ist, sich die Einfügemarke jedoch in einem Wort befindet, wird die Formatierung auf das Wort angewendet. Der SCF_WORD-Wert muss in Verbindung mit dem SCF_SELECTION-Wert verwendet werden.

lParam

Zeiger auf eine CHARFORMAT-Struktur , die die zu verwendende Zeichenformatierung angibt. Nur die vom dwMask-Element angegebenen Formatierungsattribute werden geändert.

Microsoft Rich Edit 2.0 und höher: Dieser Parameter kann ein Zeiger auf eine CHARFORMAT2-Struktur sein, die eine Erweiterung der CHARFORMAT-Struktur ist. Legen Sie vor dem Senden der EM_SETCHARFORMAT-Nachricht den cbSize-Member der Struktur auf sizeof(CHARFORMAT) fest, oder sizeof(CHARFORMAT2) geben Sie an, welche Version der Struktur verwendet wird.

Die Elemente szFaceName und bCharSet können überstimmt werden, wenn sie für Zeichen ungültig sind, z. B. Arial auf Kanji-Zeichen.

Rückgabewert

Wenn der Vorgang erfolgreich ist, ist der Rückgabewert ein Nonzero-Wert.

Wenn der Vorgang fehlschlägt, ist der Rückgabewert 0.

Bemerkungen

Wenn diese Nachricht mehr als einmal mit denselben Parametern gesendet wird, wird die Auswirkung auf den Text umgeschaltet. Das heißt, das Senden der Nachricht erzeugt einmal den Effekt, das zweimalige Senden der Nachricht bricht den Effekt ab usw.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Richedit.h

Weitere Informationen

Referenz

CHARFORMAT

CHARFORMAT2