CWnd::DlgDirListComboBox

Článek
06/10/2015

Vyplní pole seznamu, poli se seznamem výpis souboru nebo adresáře.

int DlgDirListComboBox( 
   LPTSTR lpPathSpec, 
   int nIDComboBox, 
   int nIDStaticPath, 
   UINT nFileType  
);

Parametry

lpPathSpec
Odkazuje na řetězec zakončený hodnotou null, který obsahuje cestu nebo název souboru.DlgDirListComboBoxTento řetězec upraví tak, aby tato data by neměl být ve formě řetězcový literál.Naleznete v následující části "Poznámky".
nIDComboBox
Určuje identifikátor pole se seznamem v dialogovém okně.Pokud nIDComboBox 0, DlgDirListComboBox předpokládá, že žádné seznamem 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, DlgDirListComboBox předpokládá, že je přítomna žádná taková kontrola textu.
nFileType
Určuje atributy souboru DOS zobrazování souborů.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 CB_DIR příznak.Pokud CB_DIR je příznak nastaven, systém Windows umístí zpráv generovaných DlgDirListComboBox 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 DlgDirListComboBox 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

Určuje výsledek funkce.Je nenulová výpis byl proveden, dokonce i prázdný seznam.Vrácená hodnota 0 znamená vstupní řetězec neobsahoval platný vyhledávací cestu.

Poznámky

DlgDirListComboBoxodešle CB_RESETCONTENT a CB_DIR zpráv do pole se seznamem.Vyplní seznam určený seznamem nIDComboBox 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á zastupuje libovolný počet znaků.

Pokud zadáte řetězec nulové délky pro lpPathSpec , bude použit aktuální adresář a lpPathSpec nebude změněn.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 pole se seznamem lpPathSpec je aktualizován odebráním jednotku nebo adresář část cesty.

Příklad

// If pDialog points to a CDialog object with a combo box 
// with the identifier IDC_DIRCOMBO, this call will populate 
// the box with only the non-hidden subdirectories in the root 
// directory of the C:\ drive. 

TCHAR szPath[MAX_PATH];
_tcsncpy_s(szPath, MAX_PATH, _T("C:\\"), MAX_PATH);
pDialog->DlgDirListComboBox(szPath, IDC_DIRCOMBO, 0, DDL_EXCLUSIVE | 
   DDL_DIRECTORY);

// Note that the first argument is a string and not a string  
// literal. This is necessary because DlgDirListComboBox  
// modifies the supplied string. Passing a string literal  
// will result in an access violation.