WPF ColorDialog颜色选择器的详细使用教程

WPF 本身并没有提供直接的 ColorDialog 控件（不像 WinForms 中的 ColorDialog）。不过，你可以通过使用 Windows Forms 的 ColorDialog，然后在 WPF 中调用该对话框来实现颜色选择功能。

要在 WPF 中使用 ColorDialog，首先需要引入 Windows Forms 的程序集，然后可以将其集成到 WPF 项目中。

1. 引入 Windows Forms 程序集

项目配置文件里面.csproj，即双击项目打开，在PropertyGroup里面增加

  <UseWindowsForms>true</UseWindowsForms>

接着，在代码中引入相关的命名空间：

using System.Windows.Forms;
using System.Windows.Media;  // For using WPF's Color structure

2. 使用 Windows Forms 的 ColorDialog

在 WPF 中使用 Windows Forms 的 ColorDialog 非常简单。以下是一个基本的颜色选择对话框示例。

private void ChooseColor_Click(object sender, RoutedEventArgs e)
{
    // 创建一个ColorDialog实例
    ColorDialog colorDialog = new ColorDialog();
    
    // 显示颜色选择对话框
    if (colorDialog.ShowDialog() == System.Windows.Forms.DialogResult.OK)
    {
        // 将选定的颜色转换为WPF的Color类型
        System.Drawing.Color selectedColor = colorDialog.Color;
        Color wpfColor = Color.FromArgb(selectedColor.A, selectedColor.R, selectedColor.G, selectedColor.B);

        // 在WPF中使用该颜色，例如更改背景色
        this.Background = new SolidColorBrush(wpfColor);
    }
}

3. 完整示例

下面是一个完整的 WPF 示例，展示了如何通过按钮点击事件打开颜色选择对话框，并将选择的颜色应用到窗口的背景颜色。

using System.Windows;
using System.Windows.Media;
using System.Windows.Forms;  // 引入 Windows Forms 命名空间
using MessageBox = System.Windows.MessageBox;  // 避免与 WinForms 的 MessageBox 冲突

namespace WpfApp
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private void ChooseColor_Click(object sender, RoutedEventArgs e)
        {
            // 创建一个ColorDialog实例
            ColorDialog colorDialog = new ColorDialog();
            
            // 显示颜色选择对话框
            if (colorDialog.ShowDialog() == System.Windows.Forms.DialogResult.OK)
            {
                // 获取选定的颜色
                System.Drawing.Color selectedColor = colorDialog.Color;

                // 将 Windows Forms 的 Color 转换为 WPF 的 Color
                Color wpfColor = Color.FromArgb(selectedColor.A, selectedColor.R, selectedColor.G, selectedColor.B);

                // 设置窗口的背景色为选中的颜色
                this.Background = new SolidColorBrush(wpfColor);
                
                // 显示选中的颜色值
                System.Windows.MessageBox.Show("You selected: " + wpfColor.ToString());
            }
        }
    }
}

4. 解释代码中的关键步骤

1. ColorDialog 实例化：通过 ColorDialog 类创建颜色选择器实例。
2. ShowDialog() 方法：ShowDialog() 方法显示颜色选择对话框，并等待用户选择颜色。返回的结果为 DialogResult.OK 表示用户点击了 “确定” 按钮。
3. 颜色转换：由于 ColorDialog 使用的是 Windows Forms 的颜色类型 System.Drawing.Color，因此需要将其转换为 WPF 的 System.Windows.Media.Color 类型。通过 Color.FromArgb() 方法，将颜色的 A（透明度）、R（红色）、G（绿色）、B（蓝色）通道值传递给 WPF 的 Color。
4. 应用颜色：将颜色应用到 WPF 控件中，比如将窗口背景颜色设置为用户选择的颜色。SolidColorBrush 是 WPF 中常用的颜色刷子类型，可以用于设置背景色或其他颜色属性。

5. ColorDialog 的其他功能

• 设置初始颜色：你可以通过 ColorDialog.Color 属性设置对话框打开时的默认颜色。例如，设置为当前窗口的背景颜色。

colorDialog.Color = System.Drawing.Color.FromArgb(
    Background.Color.A, 
    Background.Color.R, 
    Background.Color.G, 
    Background.Color.B);

• 允许自定义颜色：ColorDialog 提供了自定义颜色的选项，用户可以自己定义颜色。通过 AllowFullOpen 属性控制是否允许自定义颜色。

colorDialog.AllowFullOpen = true;

• 显示帮助按钮：如果你希望在颜色对话框中显示帮助按钮，可以设置 ShowHelp 属性。

colorDialog.ShowHelp = true;

6. 完整示例：包含自定义颜色和帮助按钮

private void ChooseColor_Click(object sender, RoutedEventArgs e)
{
    ColorDialog colorDialog = new ColorDialog();
    colorDialog.AllowFullOpen = true; // 允许自定义颜色
    colorDialog.ShowHelp = true;      // 显示帮助按钮
    colorDialog.HelpRequest += ColorDialog_HelpRequest; // 点击帮助按钮要执行的事件
    
    // 设置初始颜色为当前背景颜色
    colorDialog.Color = System.Drawing.Color.FromArgb(
        ((SolidColorBrush)this.Background).Color.A,
        ((SolidColorBrush)this.Background).Color.R,
        ((SolidColorBrush)this.Background).Color.G,
        ((SolidColorBrush)this.Background).Color.B);

    if (colorDialog.ShowDialog() == System.Windows.Forms.DialogResult.OK)
    {
        System.Drawing.Color selectedColor = colorDialog.Color;
        Color wpfColor = Color.FromArgb(selectedColor.A, selectedColor.R, selectedColor.G, selectedColor.B);
        this.Background = new SolidColorBrush(wpfColor);
    }
}

private void ColorDialog_HelpRequest(object? sender, System.EventArgs e)
{
      throw new System.NotImplementedException();
}

7. 使用第三方库实现 WPF 原生 ColorPicker

如果你希望避免依赖 Windows Forms，可以选择使用第三方 WPF 控件库，比如 Xceed.Wpf.Toolkit，它提供了原生的 WPF ColorPicker 控件，允许用户选择颜色，并且更加符合 WPF 风格。

可以通过 NuGet 包管理器添加 Xceed.Wpf.Toolkit：

Install-Package Extended.Wpf.Toolkit

然后在 XAML 中直接使用：

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:xctk="http://schemas.xceed.com/wpf/xaml/toolkit"
        Title="MainWindow" Height="350" Width="525">
    <Grid>
        <xctk:ColorPicker Name="colorPicker" SelectedColorChanged="ColorPicker_SelectedColorChanged"/>
    </Grid>
</Window>

在后端代码中处理颜色变化事件：

private void ColorPicker_SelectedColorChanged(object sender, RoutedPropertyChangedEventArgs<Color?> e)
{
    this.Background = new SolidColorBrush(e.NewValue.Value);
}

总结

• WPF 本身没有内置的 ColorDialog，但你可以通过集成 Windows Forms 的 ColorDialog 实现颜色选择功能。
• 通过 ColorDialog，你可以让用户选择颜色，并将选择结果转换为 WPF 的颜色格式，应用于控件中。
• 如果希望使用更符合 WPF 风格的颜色选择器，可以选择第三方控件库如 Xceed.Wpf.Toolkit。

这样可以让你的 WPF 应用拥有更强的颜色选择功能。