DDX_LBStringExact

The DDX_CBStringExact function manages the transfer of CString data between the edit control of a list box control in a dialog box, form view, or control view object and a CString data member of the dialog box, form view, or control view object.

void AFXAPI DDX_LBStringExact( 
   CDataExchange* pDX, 
   int nIDC, 
   CString& value  
);

Parameters

  • pDX
    A pointer to a CDataExchange object. The framework supplies this object to establish the context of the data exchange, including its direction.

  • nIDC
    The resource ID of the list box control associated with the control property.

  • value
    A reference to a member variable of the dialog box, form view, or control view object with which data is exchanged.

Remarks

When DDX_LBStringExact is called to transfer data to a list box control, the first item in the control that matches value is selected. (To match just a prefix rather than the entire item, use DDX_LBString.) If there are no matches, no items are selected. The matching is case-insensitive.

When DDX_CBStringExact is called to transfer data from a list box control, value is set to the current list box selection. If no item is selected, value is set to a string of zero length.

Note

If the list box is a drop-down list box, the value exchanged is limited to 255 characters.

For more information about DDX, see Dialog Data Exchange and Validation.

Requirements

Header: afxdd_.h

See Also

Concepts

MFC Macros and Globals

Reference

DDP_LBString

Other Resources

Standard Dialog Data Exchange Routines