CW&nd::DlgDirListnbsp;

int DlgDirList ( LPTSTR lpPathSpec, int nIDListBox, int nIDStaticPath, UINT nFileType );

Wartość zwracany

Niezerowa, jeśli funkcja jest skuteczne; inny sposób 0.

Parametry

lpPathSpec

Wskazuje ciąg zakończony znakiem null, który zawiera ścieżka lub nazwa pliku. DlgDirList modyfikuje ten ciąg, który powinien być dostatecznie długi zawiera modyfikacje. Aby uzyskać więcej informacji zobacz następującą sekcję "Uwagi".

nIDListBox

Określa identyfikator pola listy. Jeśli nIDListBox jest równa 0, DlgDirList zakłada, że nie pole listy 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 równa 0, DlgDirList zakłada, że brak takich kontroli tekst jest obecny.

nFileType

Określa atrybuty plików mają być wyświetlane. Może to być dowolna kombinacja następujących wartości:

• DDL_READWRITE   Pliki odczytu i zapisu danych z nie dodatkowych atrybutów.
  
  
• DDL_READO&NLYnbsp;  Pliki tylko do odczytu.
  
  
• DDL_HIDDE&Nnbsp;  Ukryte pliki.
  
  
• DDL_SYSTEM   Pliki systemowe.
  
  
• DDL_DIRECTORY   Katalogi.
  
  
• DDL_ARCHIVE   Archiwa.
  
  
• DDL_POSTMSGS   Flaga LB_DIR . Jeśli jest ustawiona flaga LB_DIR , system Windows umieszcza komunikatów generowanych przez DlgDirList w kolejce aplikacji; w przeciwnym razie są wysyłane bezpośrednio do procedury okno dialogowe.
  
  
• DDL_DRIVES   Dyski. Jeśli jest ustawiona flaga DDL_DRIVES , automatycznie jest ustawiona flaga DDL_EXCLUSIVE . W związku z tym, aby utworzyć listę katalogu, zawierającego pliki i dyski, należy wywołać DlgDirList dwukrotnie: raz z DDL_DRIVES flagi zestawu i raz z flagami w pozostałej części listy.
  
  
• DDL_EXCLUSIVE   Wyłączne bitów. Jeżeli wyłączną bit jest ustawiony, wymienione są tylko pliki określonego typu; w przeciwnym razie zwykłych plików i pliki określonego typu są wymienione.

Uwagi

Wypełnia pole listy lista pliku lub katalogu. Wysyła DlgDirList LB_RESETCONTENT i LB_DIR wiadomości do pola listy. Wypełnia pole listy określonej przez nIDListBox z nazw wszystkich plików, które odpowiadają ścieżki przez lpPathSpec.

Parametr lpPathSpec ma następującą postać:

[dysk:] [[\u]katalogu[\iKatalog]... \u] [nazwa_pliku]

W tym przykładzie dysku jest literą dysku, Katalog jest prawidłowa nazwa katalogu, a Nazwa pliku jest prawidłową nazwą pliku, który musi zawierać co najmniej jeden symbol wieloznaczny. Symbole wieloznaczne są znak zapytania (?), co oznacza dowolny znak i gwiazdki **, co oznacza dopasować dowolną liczbę znaków.

Jeśli można określić ciąg o długości 0 dla lpPathSpec, lub jeśli podaj tylko nazwę katalogu, ale nie zawierać specyfikacja danego pliku, ciąg zostanie zmieniona na "*. *".

Jeśli lpPathSpec zawiera dysk i/lub nazwa katalogu, bieżący dysk i katalog są zmieniane na wyznaczonych dysk i katalog, przed zrealizowaniem pola listy. Formant tekstu, identyfikowane przez nIDStaticPath to jest także aktualizowane z nowego dysku i/lub nazwa katalogu.

Po polu listy jest wypełniany, lpPathSpec jest aktualizowany przez usunięcie dysku i/lub katalog części ścieżki.

Omówienie CWnd |nbsp; Klasa członków | Wykres hierarchii

Zobacz teżnbsp;CWnd::DlgDirListComboBox, :: DlgDirList