萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

Delphi 選擇資料夾對話框完整範例

前言

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 記憶體。

copyright © 萬盛學電腦網 all rights reserved