CWnd::DlgDirList
Wypełnia pole listy z listą pliku lub katalogu.
int DlgDirList(
LPTSTR lpPathSpec,
int nIDListBox,
int nIDStaticPath,
UINT nFileType
);
Parametry
lpPathSpec
Wskazuje ciąg zakończony znakiem null, zawierającą ścieżkę lub nazwę pliku.DlgDirListModyfikuje ten ciąg znaków musi być wystarczająco długi zawiera modyfikacje.Aby uzyskać więcej informacji zobacz sekcję "Uwagi".nIDListBox
Określa identyfikator pola listy.Jeśli nIDListBox jest 0, DlgDirList zakłada, że pole listy nie istnieje i nie próbuje wypełnić jeden.nIDStaticPath
Określa identyfikator formantu tekstu statycznego, używany do wyświetlania bieżącego dysku i katalogu.Jeśli nIDStaticPath jest 0, DlgDirList zakłada, że brak kontroli tekstu jest obecny.nFileType
Określa atrybuty plików, które mają być wyświetlane.Mogą to być dowolna kombinacja następujących wartości:DDL_READWRITE plików danych do odczytu i zapisu bez dodatkowych atrybutów.
DDL_READONLY pliki tylko do odczytu.
DDL_HIDDEN pliki ukryte.
DDL_SYSTEM systemu plików.
DDL_DIRECTORY katalogów.
DDL_ARCHIVE archiwów.
DDL_POSTMSGS LB_DIR flagi.Jeśli LB_DIR jest ustawiona flaga, system Windows umieszcza komunikaty generowane przez DlgDirList w kolejce aplikacji; w przeciwnym razie są wysyłane bezpośrednio do procedury okno dialogowe.
DDL_DRIVES dysków.Jeśli DDL_DRIVES jest ustawiona flaga DDL_EXCLUSIVE automatycznie ustawiona flaga.Dlatego, aby utworzyć listę katalogów dysków i plików, należy wywołać DlgDirList dwukrotnie: raz z DDL_DRIVES flagi zestawu i raz z flagami w pozostałej części listy.
DDL_EXCLUSIVE bit wyłączności.Jeśli wyłączne bit jest ustawiony, wyświetlane są tylko pliki określonego typu; w przeciwnym razie wymienionych zwykłych plików oraz pliki określonego typu.
Wartość zwracana
Niezerowa, jeśli funkcja jest pomyślne; 0 inaczej.
Uwagi
DlgDirListwysyła LB_RESETCONTENT i LB_DIR wiadomości w polu listy.Wypełnia pole listy określonej przez nIDListBox z nazwami wszystkich plików spełniających ścieżki przez lpPathSpec.
lpPathSpec Parametr ma następującą postać:
[drive:] [ [\u]directory[\idirectory]... \u] [filename]
W tym przykładzie drive jest literą dysku, directory jest prawidłowa nazwa katalogu, i nazwę pliku jest prawidłową nazwą pliku musi zawierać co najmniej jeden symbol wieloznaczny.Symbole wieloznaczne są znakiem zapytania (?), dopasować oznacza dowolny znak, a gwiazdka (*), co odpowiada dowolnej liczby znaków.
Jeżeli określono ciąg o długości 0 dla lpPathSpec, lub jeśli określ nazwę katalogu, ale nie zawierają żadnych specyfikacji pliku ciąg zostanie zmieniony na "*. *".
Jeśli lpPathSpec zawiera nazwę dysku lub katalogu bieżącego dysku i katalogu są zmieniane na wyznaczonych dysku i katalogu, przed wypełnione jest pole listy.Formant tekstu identyfikowane przez nIDStaticPath jest również aktualizowana nową nazwę dysku lub katalogu.
Po wypełnione jest pole listy, lpPathSpec jest aktualizowana przez usunięcie dysku lub katalogu części ścieżki.
Przykład
// If pDialog points to a CDialog object with a list box
// with the identifier IDC_DIRLIST, this call will populate
// the box with only the non-hidden subdirectories in the root
// directory of the C:\ drive.
TCHAR path[MAX_PATH];
_tcscpy_s(path, MAX_PATH, _T("C:\\"));
pDialog->DlgDirList(path, IDC_DIRLIST, 0, DDL_EXCLUSIVE | DDL_DIRECTORY);
Wymagania
Nagłówek: afxwin.h