CB_LIMITTEXT

3.0

CB_LIMITTEXT
wParam = (WPARAM) cchLimit;   /* maximum number of characters */
lParam = 0L;                  /* not used, must be zero       */

An application sends a CB_LIMITTEXT message to limit the length of the text that the user may type in the edit control of a combo box.

Parameters

cchLimit

Value of wParam. Specifies the length, in bytes, of the text the user can enter. If this parameter is zero, the text length is set to 65,535 bytes.

Return Value

The return value is 1 if the message is successful. If this message is sent to a combo box with the style CBS_DROPDOWNLIST, the return value is CB_ERR.

Comments

If the combo box does not have the style CBS_AUTOHSCROLL, setting the text limit to be larger than the size of the edit control has no effect.

The CB_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 when a string in the list box is selected.

Example

This example limits the text of the edit control of a combo box to five characters:

SendDlgItemMessage(hdlg, ID_MYCOMBOBOX, CB_LIMITTEXT, 5, 0L);