CWnd::DlgDirList
Liste kutusunda bir dosya veya dizin listesini doldurur.
int DlgDirList(
LPTSTR lpPathSpec,
int nIDListBox,
int nIDStaticPath,
UINT nFileType
);
Parametreler
lpPathSpec
Yol veya dosya adı içeren boş sonlandırılmış bir dizeye işaret ediyor. DlgDirListdeğişiklikleri içermesi için yeterince uzun olmalıdır, bu dize değiştirir. Daha fazla bilgi için aşağıdaki "Açıklamalar" bölümüne bakın.nIDListBox
Bir liste kutusu tanımlayıcısını belirtir. nIDListBox 0'dır ve DlgDirList hiçbir liste kutusu varsa ve bir dolgu denemez varsayar.nIDStaticPath
Geçerli sürücü ve dizini görüntülemek için kullanılan statik metin denetimi tanımlayıcısını belirtir. nIDStaticPath 0'dır ve DlgDirList bu tür bir metin denetimi yüklü olduğunu varsayar.nFileType
Görüntülenecek dosyaların özniteliklerini belirtir. Herhangi bir birleşimini aşağıdaki değerlerden biri olabilir:DDL_READWRITE okuma-yazma veri dosyaları ek özniteliği yok.
ddl_readonly salt okunur dosyalar.
DDL_HIDDEN gizli dosyaları.
ddl_system sistem dosyaları.
DDL_DIRECTORY dizinler.
DDL_ARCHIVE arşivler.
DDL_POSTMSGS LB_DIR bayrağı. LB_DIR bayrağı ayarlanmışsa, Windows tarafından üretilen iletileri yerleştirir DlgDirList uygulamanın sırasındaki; Aksi durumda, doğrudan iletişim yordamı gönderilir.
DDL_DRIVES sürücüler. DDL_DRIVES bayrağı ayarlanmışsa, DDL_EXCLUSIVE bayrağı otomatik olarak ayarlanır. Bu nedenle, sürücüler ve dosyalar içeren dizin listesini oluşturmak için çağırmanız gerekir DlgDirList iki kez: bir kez ile DDL_DRIVES bayrak kümesi ve bir kez listeye geri kalanı için bayraklı.
DDL_EXCLUSIVE özel bit. Özel bit ayarlanmışsa, yalnızca belirli türdeki dosyaları listelenir; Aksi takdirde normal ve belirtilen türdeki dosyaları listelenmiştir.
Dönüş Değeri
Sıfır olmayan bir değer işlevi başarılı olursa; Aksi halde 0.
Notlar
DlgDirListGönderen lb_resetcontent ve LB_DIR liste kutusu iletileri. Belirtilen liste kutusunu doldurur nIDListBox tarafından verilen yolun eşleşen tüm dosyaların adları ile lpPathSpec.
lpPathSpec Parametresi aşağıdaki biçime sahiptir:
[drive:] [ [\u]directory[\idirectory]... \u] [filename]
Bu örnekte, drive bir sürücü harfi olan directory geçerli dizin adı ve Dosya adı en az bir joker karakter içermesi gereken geçerli bir dosya adı değil. Joker karakterler, soru işareti olan (?), herhangi bir karakter ve bir yıldız eşleşme hangi anlamına gelir (*), herhangi bir sayıdaki karakteri eşleştirmek anlamına gelir.
İçin 0 uzunluğunda bir dize belirtirseniz, lpPathSpec, ya da yalnızca dizin adını belirtir, ancak herhangi bir dosya belirtimi içermeyen dize değiştirilecek "*. *".
lpPathSpec Sürücü ve/veya dizin adı içeren liste kutusunun doldurulması geçerli sürücü ve dizini belirtilen sürücü ve dizini değiştirilir. Metin denetimi tarafından tanımlanan nIDStaticPath yeni sürücü ve/veya dizin adı da güncelleştirilir.
Liste kutusu dolu sonra lpPathSpec yolu sürücü ve/veya dizin bölümünü kaldırarak güncelleştirilir.
Örnek
// 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);
Gereksinimler
Başlık: afxwin.h