DlgDirList是一種函式,該函式用與指定的檔案名稱匹配的所有檔案的名字填充列表框。
基本介紹
- 中文名:DlgDirList
- 功能:指定的檔案名稱匹配填充列表框
- 原型:nt DlgDirList
- hDlg:包含列表框的對話框句柄
- 庫檔案:user32.lib
介紹,功能,原型,參數,返回值,備註,
介紹
功能
該函式用與指定的檔案名稱匹配的所有檔案的名字填充列表框。
原型
int DlgDirList(HWND hDlg,LPTSTR lpPathSpec,int nlDListBox,int nlDStaticPath,UINT uFileType);
參數
hDlg:包含列表框的對話框句柄。
lpPathSpec:指向包含路徑名或檔案名稱的以NULL結尾的字元串指針。DIgDirList修改此串,該串必須有足夠的長度來保存修改的內容。關於此參數的更詳盡的信息,請看備註部分。
nlDListBox:定義一個列表框的標示。如果該參數為0,DlgDirList函式認為沒有列表框存在,也不試圖填充。
nlDStaticPath:定義用於顯示當前驅動器和目錄的靜態控制的標識符。若此參數為0,DlgDirList認為不存在這樣的控制。
nFileType:定義將要顯示的檔案名稱字的屬性。該參數必須是一個或多個如下的值:
DDL_ARCHIVE:包含文檔檔案。DDL_DIRECTORY:包含於目錄。於目錄名包含在方括弧中。
DDL_DRIVES:包含驅動器。驅動器以[一X」的形式列出,其中X是驅動器符。
DDL_EXCLUSIVE:僅包含指定屬性的檔案。預設情況下,可讀寫的檔案將被列出,儘管並未指定DDL_READWRITE值。DDL_HIDDEN:包含隱含檔案。
DDL_READONLy:包含唯讀檔案。DDL_READWRITE:包含沒有其他附加屬性的可讀寫檔案。
返回值
備註
若對於lpPathSpec參數定義了一個0長度的串,或者僅定義了一個目錄名,而沒有檔案名稱,則串被轉換為‘.’。
lpPathSgec參數有如下形式:[drive:][\u]directory[\idirectory]\u][filename]
在這個例子中,drive是一個驅動器符,directory是一個有效的驅動器名,filename是一個有效的檔案名稱,檔案名稱中必須包含至少一個通配符。
若lpPathSpec包含一個驅動器或目錄名,或同時包含兩者,則在列表框被填充以前,當前的驅動器和目錄將被改變為指定的驅動器和目錄。nlDStaticPath參數標識的靜態控制也被用新的驅動器或/和目錄名來更新。
列表框填充以後,DlgDirList通過移去路徑和檔案名稱的驅動器和/或目錄部分來更新lpPathSpec參數。
DlgDirList傳送LB_RESETCONTENT和LB_DIR訊息給列表框。
速查:Windows NT: 3.1及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:winuser.h;庫檔案:user32.lib;Unicode:在Windows NT上實現為Unicode和ANSI兩種版本。