EM_SETTEXTMODE Nachricht

Legt den Textmodus oder die Rückgängig-Ebene eines rich-Bearbeitungssteuerelements fest. Die Meldung schlägt fehl, wenn das Steuerelement Text enthält.

Parameter

wParam

Mindestens ein Wert aus dem TEXTMODE-Enumerationstyp . Die -Werte geben die neuen Einstellungen für den Textmodus des Steuerelements und die Parameter zum Rückgängigmachen der Ebene an.

Geben Sie einen der folgenden Werte an, um den Textmodusparameter festzulegen. Wenn Sie keinen Textmoduswert angeben, bleibt der Textmodus bei seiner aktuellen Einstellung.

Wert	Bedeutung
TM_PLAINTEXT	Gibt den Nur-Text-Modus an, in dem das Steuerelement einem Standardbearbeitungssteuerelement ähnelt. Weitere Informationen zum Nur-Text-Modus finden Sie im folgenden Abschnitt hinweise.
TM_RICHTEXT	Gibt den Rich-Text-Modus an, in dem das Steuerelement standardmäßig über umfassende Bearbeitungsfunktionen verfügt. Der Rich-Text-Modus ist die Standardeinstellung.

Geben Sie einen der folgenden Werte an, um den Undo level-Parameter festzulegen. Wenn Sie keinen Wert für die Rückgängig-Ebene angeben, bleibt die Rückgängig-Ebene bei der aktuellen Einstellung.

Wert	Bedeutung
TM_SINGLELEVELUNDO	Mit dem -Steuerelement kann der Benutzer nur die letzte Aktion rückgängig machen, die rückgängig machen kann.
TM_MULTILEVELUNDO	Das Steuerelement unterstützt mehrere Rückgängig-Vorgänge. Dies ist die Standardeinstellung. Verwenden Sie die EM_SETUNDOLIMIT Meldung, um die maximale Anzahl von Rückgängig-Aktionen festzulegen.

Geben Sie einen der folgenden Werte an, um den Codepageparameter festzulegen. Wenn Sie keinen Codepagewert angeben, bleibt die Codepage bei ihrer aktuellen Einstellung.

Wert	Bedeutung
TM_SINGLECODEPAGE	Das -Steuerelement lässt nur die englische Tastatur und eine Tastatur zu, die dem Standardzeichensatz entspricht. Sie könnten beispielsweise Griechisch und Englisch haben. Beachten Sie, dass dadurch verhindert wird, dass Unicode-Text in das Steuerelement eintritt. Verwenden Sie diesen Wert beispielsweise, wenn ein Rich Edit-Steuerelement auf ANSI-Text beschränkt sein muss.
TM_MULTICODEPAGE	Das Steuerelement lässt mehrere Codepages und Unicode-Text in das Steuerelement zu. Dies ist die Standardeinstellung.

lParam

Dieser Parameter wird nicht verwendet. sie muss 0 (null) sein.

Rückgabewert

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert null.

Wenn die Nachricht fehlschlägt, ist der Rückgabewert ein Wert ungleich null.

Bemerkungen

Im Rich-Text-Modus verfügt ein Rich-Edit-Steuerelement über standardmäßige umfassende Bearbeitungsfunktionen. Im Nur-Text-Modus ähnelt das Steuerelement jedoch einem standardmäßigen Bearbeitungssteuerelement:

• Der Text in einem Nur-Text-Steuerelement kann nur ein Format aufweisen (z. B. Fett, 10Pt Arial).
• Der Benutzer kann keine Rich-Text-Formate, z. B. RICH-Text-Format (RTF) oder eingebettete Objekte, in ein Nur-Text-Steuerelement einfügen.
• Rich-Text-Modus-Steuerelemente verfügen immer über eine Standardmäßige End-of-Dokument-Markierung oder wagenrücklauf, um Absätze zu formatieren. Nur-Text-Steuerelemente benötigen dagegen nicht den standardmäßigen Marker für das Dokumentende, daher wird er weggelassen.

Das Steuerelement darf keinen Text enthalten, wenn es die EM_SETTEXTMODE Nachricht empfängt. Um sicherzustellen, dass kein Text vorhanden ist, senden Sie eine WM_SETTEXT Nachricht mit einer leeren Zeichenfolge ("").

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

Siehe auch

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE

WM_SETTEXT