EM_SETTEXTMODE Nachricht

Legt den Textmodus oder die Rückgängig-Ebene eines Rich-Edit-Steuerelements fest. Die Nachricht schlägt fehl, wenn das Steuerelement Text enthält.

Die Parameter

wParam-

Mindestens ein Wert aus dem TEXTMODE-Enumerationstyp . Die Werte geben die neuen Einstellungen für den Textmodus des Steuerelements und Parameter für die Rückgängig-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 standardmäßigen Bearbeitungssteuerelement ä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 über standardmäßige Rich-Edit-Funktionen verfügt. Der Rich-Text-Modus ist die Standardeinstellung.

Geben Sie einen der folgenden Werte an, um den Parameter für die Rückgängig-Ebene festzulegen. Wenn Sie keinen Rückgängig-Ebenenwert 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 gemacht werden kann.
TM_MULTILEVELUNDO	Das Steuerelement unterstützt mehrere Rückgängig-Vorgänge. Dies ist die Standardeinstellung. Verwenden Sie die EM_SETUNDOLIMIT Nachricht, um die maximale Anzahl von Rückgängig-Aktionen festzulegen.

Geben Sie einen der folgenden Werte an, um den Codeseitenparameter festzulegen. Wenn Sie keinen Codeseitenwert angeben, bleibt die Codeseite bei der aktuellen Einstellung.

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

lParam-

Dieser Parameter wird nicht verwendet; es muss 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 Rich-Edit-Funktionen. 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, 10 Pt. Arial).
• Der Benutzer kann Rich-Text-Formate, z. B. RTF (Rich Text Format) oder eingebettete Objekte nicht in ein Nur-Text-Steuerelement einfügen.
• Rich-Text-Modus-Steuerelemente verfügen immer über eine standardmäßige End-of-Document-Markierung oder Wagenrücklauf, um Absätze zu formatieren. Nur-Text-Steuerelemente benötigen dagegen nicht die Standardmäßige End-of-Document-Markierung, sodass sie weggelassen wird.

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

Siehe auch

EM_GETTEXTMODE

EM_SETUNDOLIMIT

TEXTMODE-

WM_SETTEXT