Export (0) Print
Expand All
Expand Minimize

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.

ValueMeaning
TM_PLAINTEXTIndicates 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_RICHTEXTIndicates 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.

ValueMeaning
TM_SINGLELEVELUNDOThe control allows the user to undo only the last action that can be undone.
TM_MULTILEVELUNDOThe 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.

ValueMeaning
TM_SINGLECODEPAGEThe 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_MULTICODEPAGEThe 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

See also

EM_GETTEXTMODE
EM_SETUNDOLIMIT
TEXTMODE
WM_SETTEXT

 

 

Community Additions

ADD
Show:
© 2014 Microsoft