DlgDirList

DlgDirList işlevi belirtilen yol ya da dosya adı eşleşen tüm dosyaları belirtilen liste kutusunda adları ile doldurur.

int DlgDirList) hwnd  hDlg, / / tanıtıcı iletişim kutusundaki liste kutusulptstrlpPathSpec, / / yolu veya dosya adı dize işaretçisiintnIDListBox, / / liste kutusu tanıtıcısıintnIDStaticPath, / / statik denetim tanıtıcısıUINTuFileType / / dosya özniteliklerini görüntülemek için);
 

Parametreleri

hDlg
Liste kutusu içeren iletişim kutusuna tanıtıcı.
lpPathSpec
İşaretçi boş sonlandırılmış yolunu veya dosya adını içeren bir dize. DlgDirList değişiklikleri içermesi için yeterince uzun olmalıdır bu dizesini değiştirir. Bu parametre hakkında daha fazla bilgi için açıklamalar bölümüne bakın.
nIDListBox
Liste kutusu tanımlayıcısını belirtir. Bu parametreyi sıfır ise, 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 denetimin tanımlayıcısını belirtir. Bu parametreyi sıfır ise, DlgDirList böyle bir denetimi olmadığını varsayar.
uFileType
Görüntülenecek dosya özniteliklerini belirtir. Bu parametre, bir veya daha aşağıdaki değerleri olmalıdır:
Değer Açıklama
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 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

LpPathSpec parametresi için sıfır uzunlukta bir dize belirtin veya yalnızca bir dizin adı ile dosya adı belirtirseniz, dize değiştirilir *. *

LpPathSpec parametresi aşağıdaki biçime sahiptir:

[sürücü:] [[\u]dizini[\idizini] \u] [DosyaAdı[]

Örneğin, bir sürücünün sürücü harfidir, dizini geçerli bir dizin adı ve Dosya adı en az bir joker karakter içermelidir geçerli bir dosya adı (? ya *).

LpPathSpec bir sürücü veya dizin adı veya her ikisi de varsa, önce liste kutusuna girilir geçerli sürücü ve dizini belirtilen sürücü ve dizini için değiştirilir. NIDStaticPath parametresi tarafından tanımlanan statik denetimi de yeni sürücü veya dizin adı veya her ikisi ile güncelleştirilir.

Sürücü veya dizin bölümü ya da her ikisi de, dosya adını ve yolunu kaldırarak sonra liste kutusu doludur, DlgDirList lpPathSpec ' ı güncelleştirir.

DlgDirList , liste kutusuna lb_resetcontent ve LB_DIR iletileri gönderir.

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:

Liste kutuları genel bakış, liste kutusunun işlevler, DlgDirListComboBox, DlgDirSelectComboBoxEx, DlgDirSelectEx

Index