DlgDirListComboBox

Funkcja DlgDirListComboBox wypełnia pole kombi określony w wyświetlaniu zawartości katalogu. Wypełnia listę nazw wszystkich plików, dysków i podkatalogów, które odpowiadają określonym atrybuty i ciąg ścieżki.

int DlgDirListComboBox ( HWND  hDlg, / / dojście do okna dialogowego z pola kombiLPTSTRlpPathSpec, / / wskaźnik na ciąg, ścieżka lub nazwa plikuintnIDComboBox, / / identyfikator pola kombiintnIDStaticPath, / / identyfikator formantu statyczneUINTuFiletype / / atrybuty do wyświetlenia pliku);
 

Parametry

hDlg

Dojście do okna dialogowego, który zawiera pola kombi.

lpPathSpec

Wskaźnik na ciąg zakończony wartością zerową następującą formę:

[drive:][\]][Katalog\[...]][nazwa_pliku]

Jeśli określony ciąg zawiera dysk i ścieżkę katalogu, funkcja DlgDirListComboBox zmienia bieżący dysk i katalog przed wypełnieniem listy. Po liście jest wypełniany, ścieżka dysku i katalogu zostaną usunięte z ciąg określony przez parametr lpPathSpec.

nIDComboBox

Określa identyfikator formant pola kombi w oknie dialogowym. Jeżeli nIDComboBox jest równe zero, funkcja DlgDirListComboBox zakłada nie pola kombi istnieje i nie próbuje go wypełnić.

nIDStaticPath

Określa identyfikator formantu statyczny tekst, w którym funkcja DlgDirListComboBox jest wyświetlany w bieżącym katalogu. Jeśli nIDStaticPath jest równe zero, DlgDirListComboBox zakłada się, że brak takich kontroli jest obecny.

uFiletype

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

Wartość	Znaczenie
DDL_ARCHIVE	Zawiera zarchiwizowanych plików.
DDL_DIRECTORY	Zawiera podkatalogów. Nazwy podkatalogu są ujęte w nawiasy kwadratowe ([]).
DDL_DRIVES	Zawiera dyski. Dyski są wymienione w formularzu [-x-], gdzie x to litera dysku.
DDL_EXCLUSIVE	Dotyczy tylko plików o określonych atrybutach. Domyślnie odczytu i zapisu plików są wymienione, nawet, jeśli nie określono DDL_READWRITE.
DDL_HIDDEN	Zawiera ukryte pliki.
DDL_READONLY	Zawiera pliki tylko do odczytu.
DDL_READWRITE	Obejmuje pliki odczytu i zapisu z nie dodatkowych atrybutów.
DDL_SYSTEM	Zawiera pliki systemowe.
DDL_POSTMSGS	Księguje wiadomości do kolejki wiadomości aplikacji. Domyślnie funkcja DlgDirList wysyła wiadomości bezpośrednio do procedury pole dialogowe.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Na przykład jeśli ciąg określony przez lpPathSpec nie jest prawidłową ścieżką, nie działa funkcja. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Jeśli parametr lpszPathSpec wskazuje ciąg o zerowej długości lub jako ciąg znaków określający dysk i/lub w katalogu — ale nie nazwa_pliku — nazwa pliku *. * zakłada (symboli wieloznacznych).

Windows NT:

Katalogu wyświetla długich nazw plików, jeśli.

Windows 95:

Katalogu Wyświetla krótkie nazwy plików (formularz 8.3). Można użyć funkcji SHGetFileInfo lub GetFullPathName , aby uzyskać odpowiednie długich nazw plików.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Omówienie pola kombi, pole kombi funkcje, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index