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 或更新版本:Microsoft Layer for Unicode (MSLU) 支援 DlgDirSelectComboBoxExW 。 若要使用此方式,您必須將特定檔案新增至您的應用程式,如 Windows Me/98/95 Systems 上的 Microsoft Layer for Unicode 中所述。
注意
winuser.h 標頭會根據 UNICODE 預處理器常數的定義,將 DlgDirSelectComboBoxEx 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包括 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
另請參閱
參考