EM_SETTEXTMODE message

Sets the text mode or undo level of a rich edit control. The message fails if the control contains any text.

Parameters

wParam

One or more values from the TEXTMODE enumeration type. The values specify the new settings for the control's text mode and undo level parameters.

Specify one of the following values to set the text mode parameter. If you do not specify a text mode value, the text mode remains at its current setting.

Value	Meaning
TM_PLAINTEXT	Indicates plain text mode, in which the control is similar to a standard edit control. For more information about plain text mode, see the following Remarks section.
TM_RICHTEXT	Indicates rich text mode, in which the control has standard rich edit functionality. Rich text mode is the default setting.

 

Specify one of the following values to set the undo level parameter. If you do not specify an undo level value, the undo level remains at its current setting.

Value	Meaning
TM_SINGLELEVELUNDO	The control allows the user to undo only the last action that can be undone.
TM_MULTILEVELUNDO	The control supports multiple undo operations. This is the default setting. Use the EM_SETUNDOLIMIT message to set the maximum number of undo actions.

 

Specify one of the following values to set the code page parameter. If you do not specify an code page value, the code page remains at its current setting.

Value	Meaning
TM_SINGLECODEPAGE	The control only allows the English keyboard and a keyboard corresponding to the default character set. For example, you could have Greek and English. Note that this prevents Unicode text from entering the control. For example, use this value if a Rich Edit control must be restricted to ANSI text.
TM_MULTICODEPAGE	The control allows multiple code pages and Unicode text into the control. This is the default setting.

 

lParam

This parameter is not used; it must be zero.

Return value

If the message succeeds, the return value is zero.

If the message fails, the return value is a nonzero value.

Remarks

In rich text mode, a rich edit control has standard rich edit functionality. However, in plain text mode, the control is similar to a standard edit control:

• The text in a plain text control can have only one format (such as Bold, 10pt Arial).
• The user cannot paste rich text formats, such as Rich Text Format (RTF) or embedded objects into a plain text control.
• Rich text mode controls always have a default end-of-document marker or carriage return, to format paragraphs. Plain text controls, on the other hand, do not need the default, end-of-document marker, so it is omitted.

The control must contain no text when it receives the EM_SETTEXTMODE message. To ensure there is no text, send a WM_SETTEXT message with an empty string ("").

Requirements

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Richedit.h