The EM_SETEDITSTYLE message sets the current edit style flags.

Syntax

To send this message, call the SendMessage function as follows.

lResult = SendMessage(    // returns LRESULT in lResult
   hWndControl,           // (HWND) handle to destination control
   EM_SETEDITSTYLE,       // (UINT) message ID
   wParam,                // = (WPARAM)(DWORD) wParam; 
   lParam                 // = (LPARAM)(DWORD) lParam;
);

Parameters

wParam

Specifies one of the following values.

SES_EMULATESYSEDIT

When this bit is on, rich edit attempts to emulate the system edit control.

SES_BEEPONMAXTEXT

Rich Edit will call the system beeper if the user attempts to enter more than the maximum characters.

SES_EXTENDBACKCOLOR

Extends the background color all the way to the edges of the client rectangle.

SES_USEAIMM

Uses the AIMM input method component that ships with Microsoft Internet Explorer 4.0 or later.

SES_UPPERCASE

Converts all input characters to uppercase.

SES_LOWERCASE

Converts all input characters to lowercase.

SES_NOINPUTSEQUENCECHK

When this bit is on, rich edit does not verify the sequence of typed text. Some languages (such as Thai and Vietnamese) require verifying the input sequence order before submitting it to the backing store.

SES_XLTCRCRLFTOCR

Turns on translation of CRCRLFs to CRs. When this bit is on and a file is read in, all instances of CRCRLF will be converted to hard CRs internally. This will affect the text wrapping. Note that if such a file is saved as plain text, the CRs will be replaced by CRLFs. This is the .txt standard for plain text.

SES_NOIME

Disallows IMEs for this control instance.

SES_BIDI

Turns on bidirectional processing. This is automatically turned on by Microsoft Rich Edit if any of the following window styles are active: WS_EX_RIGHT, WS_EX_RTLREADING, WS_EX_LEFTSCROLLBAR. However, this setting is useful for handling these window styles when using a custom implementation of ITextHost.

SES_SCROLLONKILLFOCUS

When KillFocus occurs, scroll to the beginning of the text (cp=0).

SES_DRAFTMODE

Windows XP SP1: Use draftmode fonts to display text. Draft mode is an accessibility option where the control displays the text with a single font; the font is determined by the system setting for the font used in message boxes. For example, accessible users may read text easier if it is uniform, rather than a mix of fonts and styles.

SES_USECTF

Windows XP SP1: Turns on Text Services Framework (TSF) support.

SES_HIDEGRIDLINES

Windows XP SP1: If the table gridlines width is zero, gridlines are not displayed. This is equivalent to the hide gridlines feature in Microsoft Word's table menu.

SES_USEATFONT

Windows XP SP1: Uses an @ font, which is designed for vertical text; this is used with the ES_VERTICAL window style. The name of an @ font begins with the @ symbol, for example, "@Batang."

SES_CTFALLOWEMBED

Windows XP SP1: Allows embedded objects to be inserted using TSF.

SES_CTFALLOWSMARTTAG

Windows XP SP1: Allows TSF SmartTag tips.

SES_CTFALLOWPROOFING

Windows XP SP1: Allows TSF proofing tips.

lParam

A mask consisting of one or more of the wParam values. Only the values specified in this mask will be set or cleared. This allows a single flag to be set or cleared without reading the current flag states.

Return Value

The return value is the state of the edit style flags after rich edit has attempted to implement your edit style changes. The edit style flags are a set of flags that indicate the current edit style, made up of the values in the preceding table.

Message Information

Header	Declared in Richedit.h
Minimum operating systems	Windows 95 with Rich Edit 3.0, Windows NT 4.0 with Rich Edit 3.0, Windows Millennium Edition, Windows 2000

See Also

EM_GETEDITSTYLE