Ookii.Dialogs.Wpf库的使用

Ookii.Dialogs.Wpf 是一个为 WPF 应用程序提供增强对话框功能的类库，支持任务对话框、凭据对话框、进度对话框以及通用文件对话框等多种常用对话框。以下是关于其使用的详细介绍：

1. 安装¶

通过 NuGet 安装 Ookii.Dialogs.Wpf 包：

Install-Package Ookii.Dialogs.Wpf

2. 使用示例¶

（1）任务对话框（TaskDialog）¶

任务对话框是 Windows Vista 引入的一种增强型对话框，功能比传统消息框更丰富。使用示例如下：

using Ookii.Dialogs.Wpf;

public void ShowTaskDialog()
{
    var taskDialog = new TaskDialog
    {
        WindowTitle = "打开工程",
        MainInstruction = "文件不存在",
        Content = "是否从最近列表中移除?",
        MainIcon = TaskDialogIcon.Information,
        Buttons =
        {
            new TaskDialogButton(ButtonType.Ok),
            new TaskDialogButton(ButtonType.Cancel)
        }
    };
    var result = taskDialog.ShowDialog();
    if (result.ButtonType == ButtonType.Ok)
    {
        MessageBox.Show("你点击了确定按钮。");
    }
    else if (result.ButtonType == ButtonType.Cancel)
    {
        MessageBox.Show("你点击了取消按钮。");
    }
}

（2）文件夹选择对话框（VistaFolderBrowserDialog）¶

VistaFolderBrowserDialog 提供了增强的文件夹选择功能，支持输入路径。使用示例如下：

using Ookii.Dialogs.Wpf;

public bool GetDir(string description, out string dir, string rootDir = null)
{
    dir = null;
    if (VistaFolderBrowserDialog.IsVistaFolderDialogSupported)
    {
        var dialog = new VistaFolderBrowserDialog
        {
            Description = description,
            SelectedPath = rootDir ?? Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
            Multiselect = false
        };
        if (dialog.ShowDialog() == true)
        {
            dir = dialog.SelectedPath;
            return true;
        }
    }
    return false;
}

（3）文件选择对话框（VistaOpenFileDialog）¶

VistaOpenFileDialog 提供了增强的文件选择功能，支持多选和自定义过滤器。使用示例如下：

using Ookii.Dialogs.Wpf;

public string[] GetFileOpenPath(string title, string filter)
{
    if (VistaOpenFileDialog.IsVistaFileDialogSupported)
    {
          var ofd = new VistaOpenFileDialog
            {
                Title = "导入底图",
                Filter = "dwg文件(*.dwg)|*.dwg",
                Multiselect = false,
                // InitialDirectory = Directory.Exists(settingFile.LastSelectedFolder) ? settingFile.LastSelectedFolder : ""
            };
        if (ofd.ShowDialog() ?? false)
        {
            return openFileDialog.FileNames;
        }
    }
    return null;
}

（4）进度对话框（ProgressDialog）¶

进度对话框用于显示长时间操作的进度。使用示例如下：

using Ookii.Dialogs.Wpf;

public void ShowProgressDialog()
{
     var progressDialog = new ProgressDialog
    {
        WindowTitle = "切分底图块",
        ShowCancelButton = true
    };

    // 进度条背后要做的工作，用事件订阅
    progressDialog.DoWork += ProgressDialog_DoWork;

    void ProgressDialog_DoWork(object sender, DoWorkEventArgs e)
    {
        for (int x = 0; x <= 100; x++)
        {
            if (progressDialog.CancellationPending) return;
            progressDialog.ReportProgress(x, "进度条提示语", $"Processing: {x}%");
            Thread.Sleep(100); // 模拟长时间操作
        }
    }
    progressDialog.Show();
}

3. 注意事项¶

在使用 VistaFolderBrowserDialog 和 VistaOpenFileDialog 时，如果运行环境不支持 Vista 风格对话框，会自动回退到旧版对话框。对话框的样式和行为在不同操作系统版本上可能有所不同，建议在目标操作系统上进行测试。通过以上方法，你可以轻松地在 WPF 应用程序中使用 Ookii.Dialogs.Wpf 提供的增强对话框功能，提升用户体验。