CWnd::DlgDirListComboBox
Açılan kutunun liste kutusu, bir dosya veya dizin listesini doldurur.
int DlgDirListComboBox(
LPTSTR lpPathSpec,
int nIDComboBox,
int nIDStaticPath,
UINT nFileType
);
Parametreler
lpPathSpec
Yol veya dosya adı içeren boş sonlandırılmış bir dizeye işaret ediyor. DlgDirListComboBoxBu veriler bir dize biçiminde olmamalı böylece bu dizesini değiştirir. Aşağıdaki "Açıklamalar" bölümüne bakın.nIDComboBox
İletişim kutusunda bir birleşik giriş kutusu tanımlayıcısını belirtir. nIDComboBox 0'dır ve DlgDirListComboBox hiçbir birleşik giriş kutusu var 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 DlgDirListComboBox bu tür bir metin denetimi yüklü olduğunu varsayar.nFileType
Görüntülenecek dosyaların dos dosya ö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 CB_DIR bayrağı. CB_DIR bayrağı ayarlanmışsa, Windows tarafından üretilen iletileri yerleştirir DlgDirListComboBox 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 DlgDirListComboBox 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
İşlevin sonucunu belirler. Liste yapıldı, boş bir liste sıfır. Giriş dizesi geçerli arama yolu içermiyordu 0 dönüş değeri belirtir.
Notlar
DlgDirListComboBoxGönderen cb_resetcontent ve CB_DIR birleşik giriş kutusu iletileri. Tarafından belirtilen birleşik giriş kutusunun liste kutusu doldurur nIDComboBox 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ıda karakterle eşleşme hangi anlamına gelir.
Sıfır uzunlukta bir dize için belirtirseniz, lpPathSpec, geçerli dizin kullanılır ve lpPathSpec değiştirilmeyecek. 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.
Açılan kutunun 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 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.
Gereksinimler
Başlık: afxwin.h