|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
DlgDirList
The DlgDirList function fills the specified list box with the names of all files matching
the specified path or filename.
int DlgDirList(
HWND hDlg,
| // handle to dialog box with list box
| LPTSTR lpPathSpec,
| // pointer to path or filename string
| int nIDListBox,
| // identifier of list box
| int nIDStaticPath,
| // identifier of static control
| UINT uFileType
| // file attributes to display
| );
|
|
Parameters
hDlg
Identifies the dialog box that contains the list box.
lpPathSpec
Points to a null-terminated string that contains the path or filename. DlgDirList modifies this string, which should be long enough to contain the
modifications. For more information about this parameter, see the Remarks section.
nIDListBox
Specifies the identifier of a list box. If this parameter is zero, DlgDirList assumes that no list box exists and does not attempt to fill one.
nIDStaticPath
Specifies the identifier of the static control used for displaying the current
drive and directory. If this parameter is zero, DlgDirList assumes that no such control is present.
uFileType
Specifies attributes of the filenames to be displayed. This parameter must be
one or more of the following values:
Value
| Description
| DDL_ARCHIVE
| Includes archived files.
| DDL_DIRECTORY
| Includes subdirectories. Subdirectory names are enclosed in square brackets ([
]).
| DDL_DRIVES
| Includes drives. Drives are listed in the form [-x-], where x is the drive letter.
| DDL_EXCLUSIVE
| Includes only files with the specified attributes. By default, read-write
files are listed even if DDL_READWRITE is not specified.
| DDL_HIDDEN
| Includes hidden files.
| DDL_READONLY
| Includes read-only files.
| DDL_READWRITE
| Includes read-write files with no additional attributes.
| DDL_SYSTEM
| Includes system files.
| DDL_POSTMSGS
| Posts messages to the application's message queue. By default, DlgDirList sends messages directly to the dialog box procedure.
|
Return Values
If a listing is made  even an empty listing the return value is nonzero. If the input string does not contain a valid
search path, the return value is zero.
Remarks
If you specify a zero-length string for the lpPathSpec parameter or if you specify only a directory name with no filename, the
string will be changed to *.*
The lpPathSpec parameter has the following form:
[drive:] [[\u]directory[\idirectory]\u] [filename]
In this example, drive is a drive letter, directory is a valid directory name, and filename is a valid filename that must contain at least one wildcard (? or *).
If lpPathSpec includes a drive or directory name, or both, the current drive and directory
are changed to the specified drive and directory before the list box is filled.
The static control identified by the nIDStaticPath parameter is also updated with the new drive or directory name, or both.
After the list box is filled, DlgDirList updates lpPathSpec by removing the drive or directory portion, or both, of the path and
filename.
DlgDirList sends the LB_RESETCONTENT and LB_DIR messages to the list box.
See Also
DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
