共用方式為

DlgDirSelectComboBoxExA 函式 （winuser.h）

  • 發行項

使用 DlgDirListComboBox 函式，從填滿的下拉式方塊中擷取目前的選取範圍。 選取範圍會解譯為驅動器號、檔案或目錄名稱。

語法

BOOL DlgDirSelectComboBoxExA(
  [in]  HWND  hwndDlg,
  [out] LPSTR lpString,
  [in]  int   cchOut,
  [in]  int   idComboBox
);

參數

[in] hwndDlg

類型：HWND

包含下拉式方塊之對話框的句柄。

[out] lpString

類型：LPTSTR

接收選取路徑之緩衝區的指標。

[in] cchOut

類型：int

lpString 參數所指向之緩衝區的長度，以字元為單位。

[in] idComboBox

類型：int

對話框中下拉式方塊控件的整數標識碼。

傳回值

類型：BOOL

如果目前的選取範圍是目錄名稱，則傳回值為非零值。

如果目前的選取範圍不是目錄名稱，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

如果目前的選取範圍指定目錄名稱或驅動器號，則 DlgDirSelectComboBoxEx 函式會移除括住方括號（以及驅動器號的連字元），以便將名稱或字母插入新的路徑或檔名中。 如果沒有選取專案，lpString 所指向的緩衝區內容不會變更。

DlgDirSelectComboBoxEx 函式不允許從下拉式方塊傳回多個檔名。

如果字串長度或長度超過緩衝區，則緩衝區會包含具有終止 Null 字元的截斷字串。

DlgDirSelectComboBoxEx 會將 CB_GETCURSEL 和 CB_GETLBTEXT 訊息傳送至下拉式方塊。

您可以使用此函式搭配所有三種類型的下拉式方塊（CBS_SIMPLE、CBS_DROPDOWN和 CBS_DROPDOWNLIST）。

安全性警告：不當使用此函式可能會導致應用程式發生問題。 例如，應該針對 ANSI 和 Unicode 版本正確設定 nCount 參數。 若無法這麼做，可能會導致緩衝區溢位。 您應該先檢閱 安全性考慮：Microsoft Windows 控件 再繼續。

Windows 95 或更新版本：Unicode 的 Microsoft 層支援 DlgDirSelectComboBoxExW。 若要使用此功能，您必須將特定檔案新增至您的應用程式，如 Windows Me/98/95 Systems上 Microsoft Layer for Unicode 中所述。

注意

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

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winuser.h （包括 Windows.h）
連結庫 User32.lib
DLL User32.dll

另請參閱

CB_GETCURSEL

CB_GETLBTEXT

DlgDirListComboBox

參考