共用方式為

DlgDirListA 函式 (winuser.h)

  • 發行項

以指定目錄中子目錄和檔案的名稱取代清單框的內容。 您可以藉由指定一組檔案屬性來篩選名稱清單。 清單可以選擇性地包含對應的磁碟驅動器。

語法

int DlgDirListA(
  [in]      HWND  hDlg,
  [in, out] LPSTR lpPathSpec,
  [in]      int   nIDListBox,
  [in]      int   nIDStaticPath,
  [in]      UINT  uFileType
);

參數

[in] hDlg

類型： HWND

包含清單框之對話框的句柄。

[in, out] lpPathSpec

類型： LPTSTR

緩衝區的指標，其中包含以 Null 結尾的字串，指定絕對路徑、相對路徑或檔名。 絕對路徑的開頭可以是驅動器號 (，例如 d：) 或 UNC 名稱 (，例如 \<i>machinename\ 共用名稱) 。

函式會將字串分割成目錄和檔名。 函式會搜尋目錄，尋找符合檔名的名稱。 如果字串未指定目錄，函式會搜尋目前的目錄。

如果字串包含檔名，檔名必須至少包含一個通配符 (？或 *) 。 如果字串不包含檔名，函式的行為就如同您指定星號通配符 (*) 為檔名一樣。 指定目錄中符合檔名的所有名稱，並將 uFileType 參數所指定的屬性新增至清單框。

[in] nIDListBox

類型： int

hDlg 對話框中清單框的標識碼。 如果此參數為零， DlgDirList 不會嘗試填滿清單框。

[in] nIDStaticPath

類型： int

hDlg 對話框中靜態控件的標識碼。 DlgDirList 會設定此控制件的文字，以顯示目前的磁碟驅動器和目錄。 如果您不想顯示目前的磁碟驅動器和目錄，此參數可以是零。

[in] uFileType

類型： UINT

指定要新增至清單框的檔案或目錄屬性。 此參數可以是下列一或多個值。

值 意義
DDL_ARCHIVE
 包含封存盤案。
DDL_DIRECTORY
 包含子目錄。 子目錄名稱會以方括弧括住， ([ ]) 。
DDL_DRIVES
 所有對應的磁碟驅動器都會新增至清單。 磁碟驅動器會以 [- x-] 的形式列出，其中 x 是驅動器號。
DDL_EXCLUSIVE
 只包含具有指定屬性的檔案。 根據預設，即使未指定DDL_READWRITE，仍會列出讀取/寫入檔案。
DDL_HIDDEN
 包含隱藏的檔案。
DDL_READONLY
 包含唯讀檔案。
DDL_READWRITE
 包含沒有其他屬性的讀取/寫入檔案。 這是預設值。
DDL_SYSTEM
 包含系統檔案。
DDL_POSTMSGS
 如果設定， DlgDirList 會使用 PostMessage 函式將訊息傳送至清單框。 如果未設定， DlgDirList 會使用 SendMessage 函式。

傳回值

類型： int

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 例如，如果 lpPathSpec 指定的字串不是有效的路徑，函式就會失敗。 若要取得延伸錯誤資訊，請呼叫 。

備註

如果 lpPathSpec 指定目錄， DlgDirListComboBox 會在填滿清單方塊之前，將目前目錄變更為指定的目錄。 nIDStaticPath 參數所識別之靜態控件的文字會設定為新目前目錄的名稱。

DlgDirList 會將 LB_RESETCONTENT 和 LB_DIR 訊息傳送至清單框。

如果 uFileType 包含DDL_DIRECTORY旗標， 而 lpPathSpec 指定第一層目錄，例如 C：\TEMP，清單框一律會包含根目錄的 “..”。 即使根目錄具有隱藏或系統屬性，而且未指定DDL_HIDDEN和DDL_SYSTEM旗標，也是如此。 NTFS 磁碟區的根目錄具有隱藏和系統屬性。

目錄清單會顯示長檔名，如果有的話。

範例

如需範例，請參閱下列主題： 在單選清單框中建立目錄清單 和 建立多重選取清單框。

注意

winuser.h 標頭會將 DlgDirList 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll

另請參閱

DlgDirListComboBox

DlgDirSelectComboBoxEx

DlgDirSelectEx

參考