Delphi 中使用 FileCtrl 單元的 SelectDirectory 函數,可快速實現資料夾選擇對話框。本文提供最精簡可用的代碼範例。
uses
FileCtrl;
procedure TForm1.btn1Click(Sender: TObject);
var
Path: string;
begin
// 顯示選擇資料夾對話框
// 參數:標題、預設根目錄(空字串=桌面)、回傳選擇路徑
if SelectDirectory('請選擇資料夾', '', Path) then
ShowMessage('您選擇的路徑:' + Path);
end;
uses
FileCtrl, ShlObj, ActiveX, ComObj;
function BrowseFolderCallback(Wnd: HWND; uMsg: UINT; lParam, lpData: LPARAM): Integer; stdcall;
begin
if uMsg = BFFM_INITIALIZED then
SendMessage(Wnd, BFFM_SETSELECTION, 1, LPARAM(lpData)); // 設定預設選取路徑
Result := 0;
end;
procedure TForm1.btnSelectFolderClick(Sender: TObject);
var
BrowseInfo: TBrowseInfo;
ItemIDList: PItemIDList;
Path: array[0..MAX_PATH-1] of Char;
DefaultPath: string;
begin
DefaultPath := 'C:\Projects'; // 預設展開路徑
FillChar(BrowseInfo, SizeOf(BrowseInfo), 0);
BrowseInfo.hwndOwner := Handle;
BrowseInfo.pszDisplayName := @Path[0];
BrowseInfo.lpszTitle := '請選擇專案資料夾';
BrowseInfo.ulFlags := BIF_RETURNONLYFSDIRS or BIF_NEWDIALOGSTYLE or BIF_EDITBOX;
BrowseInfo.lpfn := BrowseFolderCallback;
BrowseInfo.lParam := LPARAM(PChar(DefaultPath));
ItemIDList := SHBrowseForFolder(BrowseInfo);
if ItemIDList <> nil then
begin
if SHGetPathFromIDList(ItemIDList, Path) then
ShowMessage('選擇路徑:' + Path);
CoTaskMemFree(ItemIDList);
end;
end;
| 旗標 | 作用 |
|---|---|
| BIF_RETURNONLYFSDIRS | 只回傳檔案系統目錄 |
| BIF_NEWDIALOGSTYLE | 新樣式對話框(可調整大小、支援編輯框) |
| BIF_EDITBOX | 顯示編輯框可直接輸入路徑 |
| BIF_BROWSEINCLUDEFILES | 包含檔案(預設只含目錄) |
簡單需求用 SelectDirectory 一行搞定;需自訂預設路徑、編輯框、新樣式 UI 時,改用 Shell API SHBrowseForFolder 並搭配回呼函數。記得引用 ShlObj、ActiveX、ComObj 單元並釋放 PItemIDList 記憶體。