The DlgDirSelectEx function retrieves the current selection from a single-selection list box. It assumes that the list box has been filled by the DlgDirList function and that the selection is a drive letter, filename, or directory name.
BOOL DlgDirSelectEx(
| HWND hDlg, | // handle to dialog box with list box |
| LPTSTR lpString, | // pointer to buffer for path string |
| int nCount, | // number of characters in path string |
| int nIDListBox | // identifier of list box |
| ); |
Parameters
hDlg
Identifies the dialog box that contains the list box.
lpString
Points to a buffer that is to receive the selected path.
nCount
Specifies the length, in characters, of the buffer pointed to by lpString.
nIDListBox
Specifies the integer identifier of a list box in the dialog box.
Return Values
If the current selection is a directory name, the return value is nonzero.
If the current selection is not a directory name, the return value is zero. To get extended error information, call GetLastError.
Remarks
The DlgDirSelectEx function copies the selection to the buffer pointed to by the lpString parameter. If the current selection is a directory name or drive letter, DlgDirSelectEx removes the enclosing square brackets (and hyphens, for drive letters), so that the name or letter is ready to be inserted into a new path. If there is no selection, lpString does not change.
DlgDirSelectEx sends LB_GETCURSEL and LB_GETTEXT messages to the list box. The function does not allow more than one filename to be returned from a list box. The list box must not be a multiple-selection list box. If it is, this function does not return a zero value and lpString remains unchanged.
See Also
DlgDirList, DlgDirListComboBox, DlgDirSelectComboBoxEx, LB_GETCURSEL, LB_GETTEXT