CWnd::DlgDirList

Článek
03/04/2013

Soubor nebo adresář výpis vyplní pole se seznamem.

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

Parametry

lpPathSpec
Odkazuje na řetězec zakončený hodnotou null, který obsahuje cestu nebo název souboru.DlgDirListupraví tento řetězec, který by měl být dostatečně dlouhé, aby obsahovat změny.Další informace naleznete v následující části "Poznámky".
nIDListBox
Určuje identifikátor seznamu.Pokud nIDListBox 0, DlgDirList předpokládá, že žádný seznam existuje a nebude pokoušet jednu výplň.
nIDStaticPath
Určuje identifikátor ovládacího prvku statický text slouží k zobrazení aktuální jednotku a adresář.Pokud nIDStaticPath 0, DlgDirList předpokládá, že je přítomna žádná taková kontrola textu.
nFileType
Určuje atributy souborů, které chcete zobrazit.Může být libovolná kombinace následujících hodnot:
- DDL_READWRITE pro čtení a zápis souborů dat bez dalších atributů.
- DDL_READONLY soubory jen pro čtení.
- DDL_HIDDEN skryté soubory.
- DDL_SYSTEM systémové soubory.
- DDL_DIRECTORY adresáře.
- DDL_ARCHIVE archivy.
- DDL_POSTMSGS LB_DIR příznak.Pokud LB_DIR je příznak nastaven, systém Windows umístí zpráv generovaných DlgDirList do fronty aplikace; jinak jsou odesílány přímo do dialogového postupu.
- DDL_DRIVES jednotek.Pokud DDL_DRIVES je příznak nastaven, DDL_EXCLUSIVE je automaticky nastaven příznak.Proto vytvořit výpis adresáře, který obsahuje jednotky a soubory, musíte zavolat DlgDirList dvakrát: jednou s DDL_DRIVES příznak sadu a jednou s příznaky pro zbytek seznamu.
- DDL_EXCLUSIVE výhradní bit.Pokud je nastaven bit výhradní, budou zobrazeny pouze soubory určeného typu; jinak jsou uvedeny běžné soubory a soubory určeného typu.

Vrácená hodnota

Nenulová hodnota, pokud je tato funkce úspěšná. jinak 0.

Poznámky

DlgDirListodešle LB_RESETCONTENT a LB_DIR zprávy do seznamu.Vyplní seznam určený nIDListBox s názvy všech souborů, které odpovídají dané cesty podle lpPathSpec .

lpPathSpec Parametr má následující tvar:

[drive:] [ [\u]directory[\idirectory]... \u] [filename]

V tomto příkladu drive je písmeno jednotky, directory je platný název adresáře, a název souboru je platný název souboru, který musí obsahovat alespoň jeden zástupný znak.Jsou zástupné znaky otazník (?), což znamená odpovídá libovolný znak a hvězdička (*), což znamená libovolného počtu znaků.

Pokud zadáte řetězec s délkou 0 pro lpPathSpec , nebo pokud zadáte pouze název adresáře, ale neobsahují žádné specifikace souboru, řetězec bude změněna na "*. *".

Pokud lpPathSpec obsahuje název jednotky nebo adresáře, než je vyplněno pole seznamu se na určenou jednotku a adresář změní aktuální jednotku a adresář.Ovládací prvek text identifikován nIDStaticPath je také aktualizován nový název jednotky nebo adresáře.

Po vyplnění pole seznamu lpPathSpec je aktualizován odebráním jednotku nebo adresář část cesty.

Příklad

// 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);