This message is sent by an application to limit the amount of text the user may enter into an edit control.
At a Glance
| Header file: | Winuser.h |
| Windows CE versions: | 1.0 and later |
Syntax
EM_LIMITTEXT wParam = (WPARAM) cchMax; lParam = 0;
Parameters
cchMax
Specifies the maximum number of characters the user can enter. If this parameter is zero, the text length is set to 0x7FFFFFFE characters for single-line edit controls or 0xFFFFFFFF for multiline edit controls.
Return Values
None.
Remarks
The maximum number of characters the user can enters different in Windows CE than it is on desktop Windows platforms. In Windows CE, if the cchMax parameter is zero, the text length is set to 0x7FFE (32,766) characters for single-line edit controls or 0xFFFF (65,535) for multiline edit controls. However, the default limit for a multiline edit control is 0xFFFFFFFF. Also, if cchMax is set to -1, the multiline edit control limit is 0xFFFFFFFF.
The EM_LIMITTEXT message limits only the text the user can enter. It has no effect on any text already in the edit control when the message is sent, nor does it affect the length of the text copied to the edit control by the WM_SETTEXT message. If an application uses the WM_SETTEXT message to place more text into an edit control than is specified in the EM_LIMITTEXT message, the user can edit the entire contents of the edit control.
The default limit to the amount of text a user can enter in an edit control is 30,000 characters.
In a rich edit control, use the message EM_EXLIMITTEXT for text length values greater than 64 KB.
See Also