DlgDirList

介紹

該函式用與指定的檔案名稱匹配的所有檔案的名字填充列表框。

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:包含沒有其他附加屬性的可讀寫檔案。

DDL_SYSTEM:包含系統檔案。DDL_POSTMSGS：傳遞訊息給應用程式的訊息佇列。預設情況下，DlgDirList直接傳送訊息給對話框過程。

若函式調用成功，則返回值不為0。若函式調用失敗，則返回值為0。例如，lpPathSpec定義的串不是一個有效路徑時，函式將失敗。若想獲的錯誤信息，可以調用GetLastError函式。

若對於lpPathSpec參數定義了一個0長度的串，或者僅定義了一個目錄名，而沒有檔案名稱，則串被轉換為‘.’。

lpPathSgec參數有如下形式：[drive：][\u]directory[\idirectory]\u][filename]

在這個例子中，drive是一個驅動器符，directory是一個有效的驅動器名，filename是一個有效的檔案名稱，檔案名稱中必須包含至少一個通配符。

若lpPathSpec包含一個驅動器或目錄名，或同時包含兩者，則在列表框被填充以前，當前的驅動器和目錄將被改變為指定的驅動器和目錄。nlDStaticPath參數標識的靜態控制也被用新的驅動器或/和目錄名來更新。

列表框填充以後，DlgDirList通過移去路徑和檔案名稱的驅動器和/或目錄部分來更新lpPathSpec參數。