DlgDirListComboBox

DlgDirListComboBox işlevi, belirtilen açılan kutu ile dizin listesini doldurur. Bu liste tüm dosyaları, sürücüler ve belirtilen öznitelikleri ve yol dizesi eşleşen alt dizinlerin isimleri ile doldurur.

int DlgDirListComboBox) hwnd  hDlg, / / işleme iletişim kutusunu Birleşik giriş kutusulptstrlpPathSpec, / / yolu veya dosya adı dize işaretçisiintnIDComboBox, / / Birleşik giriş kutusu tanıtıcısıintnIDStaticPath, / / statik denetim tanıtıcısıUINTuFiletype / / dosya özniteliklerini görüntülemek için);
 

Parametreleri

hDlg
Açılan kutu içeren iletişim kutusuna tanıtıcı.
lpPathSpec
Aşağıdaki biçimde bir boş sonlandırılmış dize işaretçisi:

[drive:][\]][dizin\[...]][DosyaAdı]

Belirtilen dize içeriyorsa, bir sürücü veya dizin yolu, DlgDirListComboBox işlevi geçerli sürücü ve dizin listesi doldurmadan önce değiştirir. Liste doldurulur sonra sürücüyü ve dizinin yolunu kaldırılır lpPathSpec parametresi tarafından belirtilen dize.

nIDComboBox
İletişim kutusu içinde bir açılan kutu denetimi tanımlayıcısını belirtir. NIDComboBox sıfır ise, DlgDirListComboBox işlevini hiçbir açılan kutu var ve doldurmak çalışmaz varsayar.
nIDStaticPath
DlgDirListComboBox işlevi geçerli dizini görüntülemek statik metin denetimin tanımlayıcısını belirtir. NIDStaticPath sıfır ise, DlgDirListComboBox böyle bir kontrol var olduğunu varsayar.
uFiletype
Görüntülenecek dosyaların özniteliklerini belirtir. Aşağıdaki değerlerin herhangi bir bileşimi olabilir:
Değer Anlamı
DDL_ARCHIVE Arşivlenen dosyaları içermektedir.
DDL_DIRECTORY Alt dizinleri içerir. Alt dizin adlarını köşeli ayraçlar ([]) içine alınır.
DDL_DRIVES Sürücüleri içerir. Sürücü x sürücü harfidir [-x-] formunda listelenir.
DDL_EXCLUSIVE Yalnızca belirtilen öznitelikleri olan dosyaları içerir. DDL_READWRITE belirtilmezse bile, varsayılan olarak, okuma-yazma dosyalar listelenir.
DDL_HIDDEN Gizli dosyaları içermektedir.
DDL_READONLY Salt okunur dosyaları içermektedir.
DDL_READWRITE Hiçbir ek öznitelikleri okuma-yazma dosyaları içermektedir.
DDL_SYSTEM Sistem dosyaları içermektedir.
DDL_POSTMSGS Uygulamanın ileti sırasına iletiler gönderir. Varsayılan olarak, DlgDirList işlev iletileri doğrudan iletişim kutusu yordama gönderir.

Dönüş değerleri

İşlev başarılı olursa, dönüş değeri sıfır.

İşlev başarısız olursa, dönüş değeri sıfırdır. LpPathSpec tarafından belirtilen dize geçerli bir yol değil, örneğin, işlev başarısız olur. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

LpszPathSpec parametresi sıfır uzunluklu bir dize veya bir sürücüyü, dizini veya her ikisini de belirten bir dizeye işaret ediyorsa — ama dosya adı — dosya *. * (joker karakter) kabul edilir.

Windows NT:
Varsa uzun dosya adları, dizin listesi görüntüler.
Windows 95:
Dizin listesinin kısa dosya adlarını (8,3 formu) görüntüler. İlgili uzun dosya adı almak için SHGetFileInfo veya GetFullPathName işlevleri kullanabilirsiniz.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Desteklenmeyen.
Header:WINUSER.h ilan etti.
İçe Library:User32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows NT olarak uygulanır.

Ayrıca bkz:

Açılan kutular genel bakış, açılan kutu fonksiyonları, DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName, SHGetFileInfo

Index