|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
DlgDirSelectEx
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
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
