LBSELCHSTRING message

[Starting with Windows Vista, the Open and Save As common dialog boxes have been superseded by the Common Item Dialog. We recommended that you use the Common Item Dialog API instead of these dialog boxes from the Common Dialog Box Library.]

An Open or Save As dialog box sends the LBSELCHSTRING registered message to your hook procedure when the selection changes in any of the list boxes or combo boxes of the dialog box.

#define LBSELCHSTRING TEXT("commdlg_LBSelChangedNotify")

Parameters

wParam

The identifier of the list box or combo box in which the selection changed.

lParam

The low-order word specifies the item number of the selected string in the list box or combo box. The high-order word specifies the type of selection change. This parameter can be one of the following values.

Value Meaning
CD_LBSELCHANGE
0
The item is the only item selected in a single-selection list box.
CD_LBSELADD
2
The item is one of the items selected in a multiple-selection list box.
CD_LBSELSUB
1
The item is no longer selected in a multiple-selection list box.
CD_LBSELNOITEMS
-1
No items exist in a multiple-selection list box.

Return value

This message has no return value.

Remarks

The hook procedure must specify the LBSELCHSTRING constant in a call to the RegisterWindowMessage function to get the identifier for the message sent by the dialog box.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Commdlg.h (include Windows.h)
Unicode and ANSI names
LBSELCHSTRINGW (Unicode) and LBSELCHSTRINGA (ANSI)

See also

Reference

CDN_SELCHANGE

CDN_TYPECHANGE

RegisterWindowMessage

Conceptual

Common Dialog Box Library