FolderBrowserDialog詳解

一、基本概念

FolderBrowserDialog是Windows Forms 目錄對話框的類。它允許用戶選擇文件夾並返回選中文件夾的路徑。

用戶操作後，將使用改選文件夾的路徑來更新FolderBrowserDialog.SelectedPath 屬性 。如果FolderBrowserDialog.ShowDialog 方法的返回值為OK ，則將使用SelectedPath的值執行特定的操作。

二、使用方法

要使用FolderBrowserDialog，需要以下步驟:

1、創建FolderBrowserDialog的實例：

“`
FolderBrowserDialog folderBrowserDialog1 = new FolderBrowserDialog();
“`

2、使用該實例的屬性設置FolderBrowserDialog：

“`
folderBrowserDialog1.Description = “Select a folder:”;
“`

可以設置Title屬性為需要展示的對話框的標題，例如”Folder Browser Dialog”。

3、調用ShowDialog方法：

“`
if (folderBrowserDialog1.ShowDialog() == DialogResult.OK)
{
//返回選擇的路徑
string path = folderBrowserDialog1.SelectedPath;
}
“`

在ShowDialog()方法返回之前，用戶始終可以更改選擇的項。如果用戶單擊「取消」按鈕，則ShowDialog()方法將返回「Cancel」結果。

三、常見功能

1、設置起始路徑

可以設置FolderBrowserDialog.SelectedPath屬性指定啟動時要顯示的文件夾路徑。例如：

“`
folderBrowserDialog1.SelectedPath = @”C:\Users”;
“`

2、禁止創建新文件夾

要禁用用戶創建新文件夾的選項，請將FolderBrowserDialog.ShowNewFolderButton屬性設置為false：

“`
folderBrowserDialog1.ShowNewFolderButton = false;
“`

3、過濾文件夾

可以使用FolderBrowserDialog.RootFolder屬性指定要從中開始瀏覽文件夾的位置。

可以使用FolderBrowserDialog.RootFolder屬性過濾FolderBrowserDialog可選擇的文件夾。例如，如果只允許用戶選擇桌面上的文件夾，則可以將該屬性設置為SpecialFolder.Desktop。

示例代碼：

“`
folderBrowserDialog1.RootFolder = Environment.SpecialFolder.Desktop;
“`

4、指定根節點

可以使用FolderBrowserDialog.RootFolder屬性指定要從中開始瀏覽文件夾的位置。

可用根路徑值有：

• Desktop
• MyDocuments
• MyComputer
• Personal

示例代碼：

“`
folderBrowserDialog1.RootFolder = Environment.SpecialFolder.Desktop;
“`

5、自定義按鈕文本

可以使用FolderBrowserDialog的UseDescriptionForTitle屬性，將FolderBrowserDialog.Description屬性中的文本用作控件的標題。

示例代碼：

“`
folderBrowserDialog1.Description = “Custom button text:”;
folderBrowserDialog1.UseDescriptionForTitle = true;
“`

四、完整示例代碼

using System;
using System.ComponentModel;
using System.Windows.Forms;

public class Form1 : Form
{
    private Button button1;
    private FolderBrowserDialog folderBrowserDialog1;

    private void InitializeComponent()
    {
        this.button1 = new System.Windows.Forms.Button();
        this.folderBrowserDialog1 = new System.Windows.Forms.FolderBrowserDialog();
        this.SuspendLayout();

        this.button1.Location = new System.Drawing.Point(75, 72);
        this.button1.Name = "button1";
        this.button1.TabIndex = 0;
        this.button1.Text = "Open folder";
        this.button1.UseVisualStyleBackColor = true;
        this.button1.Click += new System.EventHandler(this.button1_Click);

        this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 13F);
        this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
        this.ClientSize = new System.Drawing.Size(284, 262);
        this.Controls.Add(this.button1);
        this.Name = "Form1";
        this.Text = "FolderBrowserDialog";
        this.ResumeLayout(false);
    }

    private void button1_Click(object sender, EventArgs e)
    {
        folderBrowserDialog1.Description = "Browse for folder";
        folderBrowserDialog1.ShowNewFolderButton = false;
        folderBrowserDialog1.RootFolder = Environment.SpecialFolder.MyComputer;

        if (folderBrowserDialog1.ShowDialog() == DialogResult.OK)
        {
            string folderPath = folderBrowserDialog1.SelectedPath;
            MessageBox.Show(folderPath, "Selected Folder Path");
        }
    }

    static void Main()
    {
        Application.EnableVisualStyles();
        Application.SetCompatibleTextRenderingDefault(false);
        Application.Run(new Form1());
    }
}