CB_DIR訊息

將名稱新增至下拉式方塊所顯示的清單。 此訊息會新增符合指定字串和一組檔案屬性的目錄和檔案名。 CB_DIR 也可以將對應的磁碟機號新增至清單。

參數

wParam

要加入下拉式方塊之檔案或目錄的屬性。 此參數可以是下列一或多個值。

意義
DDL_ARCHIVE
包含封存檔案。
DDL_DIRECTORY
包含子目錄,以方括弧括住 ([ ]) 。
DDL_DRIVES
所有對應的磁片磁碟機都會新增至清單。 磁片磁碟機會以 [-x-] 的形式列出,其中 x 是磁碟機號。
DDL_EXCLUSIVE
只包含具有指定屬性的檔案。 根據預設,即使未指定DDL_READWRITE,仍會列出讀取/寫入檔案。
DDL_HIDDEN
包含隱藏的檔案。
DDL_READONLY
包含唯讀檔案。
DDL_READWRITE
包含沒有其他屬性的讀取/寫入檔案。 此為預設值。
DDL_SYSTEM
包含系統檔案。

lParam

指定絕對路徑、相對路徑或檔案名之 Null 終止字串的 LPCTSTR 指標。 絕對路徑的開頭可以是磁碟機號 (例如 d:) 或 UNC 名稱 (,例如 \\machinename sharename\) 。 如果字串指定檔案名或目錄,該檔案名或目錄具有 wParam 參數所指定的屬性,則會將檔案名或目錄新增至清單中。 如果檔案名或目錄名稱包含萬用字元 (?或 *) ,符合萬用字元運算式的所有檔案或目錄,並將 wParam 參數所指定的屬性新增至下拉式方塊中顯示的清單。

傳回值

如果訊息成功,傳回值會是新增至清單之姓氏之以零起始的索引。

如果發生錯誤,則會CB_ERR傳回值。 如果空間不足,無法儲存新的字串,傳回值會CB_ERRSPACE。

備註

如果 wParam 包含DDL_DIRECTORY旗標, 而 lParam 會指定第一層目錄的所有子目錄,例如 C:\TEMP\*,清單方塊一律會包含根目錄的 「..」。 即使根目錄具有隱藏或系統屬性,而且未指定DDL_HIDDEN和DDL_SYSTEM旗標,也是如此。 NTFS 磁片區的根目錄具有隱藏和系統屬性。

如果有任何名稱,清單會顯示長檔名。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]
標頭
Winuser.h (包含 Windows.h)

另請參閱

參考

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox