EM_LIMITTEXT

  • Article

This message is sent by an application to limit the amount of text the user may enter into an edit control.

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.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Winuser.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

WM_SETTEXT

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.