NMCBEENDEDITA structure (commctrl.h)

Contains information about the conclusion of an edit operation within a ComboBoxEx control. This structure is used with the CBEN_ENDEDIT notification code.

Syntax

typedef struct {
  NMHDR hdr;
  BOOL  fChanged;
  int   iNewSelection;
  char  szText[CBEMAXSTRLEN];
  int   iWhy;
} NMCBEENDEDITA, *LPNMCBEENDEDITA, *PNMCBEENDEDITA;

Members

hdr

Type: NMHDR

An NMHDR structure that contains information about the notification code.

fChanged

Type: BOOL

A value indicating whether the contents of the control's edit box have changed. This value is nonzero if the contents have been modified, or zero otherwise.

iNewSelection

Type: int

The zero-based index of the item that will be selected after completing the edit operation. This value can be CB_ERR if no item will be selected.

szText[CBEMAXSTRLEN]

Type: TCHAR

A zero-terminated string that contains the text from within the control's edit box.

iWhy

Type: int

A value that specifies the action that generated the CBEN_ENDEDIT notification code. This value can be one of the following:

Value	Meaning
CBENF_DROPDOWN	The user activated the drop-down list.
CBENF_ESCAPE	The user pressed ESC.
CBENF_KILLFOCUS	The edit box lost the keyboard focus.
CBENF_RETURN	The user completed the edit operation by pressing ENTER.

Remarks

Note

The commctrl.h header defines NMCBEENDEDIT as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	commctrl.h