mcpField
S
syncfusion-wpf-colorpicker

syncfusion-wpf-colorpicker

github.com/syncfusion开发5160 次安装1 周前更新
代码仓库

关于 syncfusion-wpf-colorpicker

这是一份在 WPF 中实现 Syncfusion ColorPicker 的参考技能，涵盖纯色与渐变的选择和编辑，以及事件处理和主题设置。

主要功能

  1. 01RGB、HSV 和十六进制颜色编辑
  2. 02纯色与渐变画笔选择
  3. 03渐变编辑器与颜色吸管
  4. 04颜色调色板和透明度控制
  5. 05主题与颜色变化事件

适用场景

  1. 01在 WPF 应用中加入颜色选择
  2. 02配置线性或径向渐变
  3. 03响应颜色或画笔变化
  4. 04为控件应用内置或自定义主题

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/syncfusion/wpf-ui-components-skills --skill syncfusion-wpf-colorpicker

安装后在 Claude Code 中输入/syncfusion-wpf-colorpicker确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
appearance-theming.md
customization.md
events-integration.md
getting-started.md
solid-gradient-colors.md

详细介绍

实现 WPF ColorPicker

ColorPicker 是一款用于选择和调整颜色值的 WPF 用户界面控件。它支持多种颜色表示方式，包括 RGB（红、绿、蓝）、HSV（色相、饱和度、明度）和十六进制代码，并内置渐变编辑器、吸管工具、调色板和主题支持。

何时使用此技能

在以下情况下使用 ColorPicker：

  • 允许用户在 WPF 应用程序中选择纯色
  • 创建具有多个颜色停靠点的线性或径向渐变画刷
  • 使用 RGB、HSV 或 Hex 输入手动编辑颜色值
  • 添加吸管工具，以便从应用中的任意位置拾取颜色
  • 控制颜色不透明度／Alpha 通道
  • 提供调色板，以便快速选择颜色
  • 处理颜色更改和画刷更改事件
  • 应用内置或自定义主题，使其与应用程序设计相匹配

导航指南

入门

📄 阅读： references/getting-started.md

  • 程序集依赖项和 NuGet 包设置
  • 通过 Designer、XAML 和 C# 添加 ColorPicker
  • 控件结构概览
  • 基本配置
纯色和渐变色

📄 阅读： references/solid-gradient-colors.md

  • 使用 Color 属性选择纯色
  • 使用 StartPoint、EndPoint 和 GradientStops 创建线性渐变
  • 使用 GradientOrigin、Center、RadiusX 和 RadiusY 创建径向渐变
  • 在运行时编辑和选择颜色
  • 使用 Alpha 通道管理不透明度
  • 在纯色、线性渐变和渐变模式之间切换
自定义选项

📄 阅读： references/customization.md

  • 启用／禁用调色板显示
  • 渐变画刷显示模式（Default 或 Extended）
  • 计算反转颜色以形成对比
  • 支持 ScRGB 颜色
  • 隐藏或显示 Alpha 值编辑器
  • 限制画刷模式切换
外观和主题

📄 阅读： references/appearance-theming.md

  • 内置主题支持
  • 集成 SfSkinManager 以应用主题
  • 使用 ThemeStudio 创建自定义主题
  • 基于主题自定义外观
事件和集成

📄 阅读： references/events-integration.md

  • 处理 ColorChanged 事件
  • 处理 SelectedBrushChanged 事件
  • 运行时颜色更改通知
  • 与其他控件的集成模式

快速入门

基本 XAML 设置
<Window xmlns:syncfusion="http://schemas.syncfusion.com/wpf">
    <Grid>
        <syncfusion:ColorPicker Name="colorPicker" 
                                Width="280" 
                                Height="100"/>
    </Grid>
</Window>
基本 C# 设置
using Syncfusion.Windows.Shared;

ColorPicker colorPicker = new ColorPicker();
colorPicker.Width = 300;
colorPicker.Height = 100;
grid.Children.Add(colorPicker);
设置初始颜色
<syncfusion:ColorPicker Color="Yellow" />

常见模式

模式 1：选择纯色 - 设置 Color 属性和 IsColorPaletteVisible="True"，供用户选择纯色。

模式 2：选择渐变 - 将 Brush 属性设置为带有 GradientStops 的 LinearGradientBrush 或 RadialGradientBrush，以选择渐变。

模式 3：响应颜色更改 - 订阅 ColorChanged 和 SelectedBrushChanged 事件，以处理实时颜色／画刷更新。

模式 4：隐藏 Alpha 通道 - 设置 IsAlphaVisible="False"，仅使用不透明颜色。

模式 5：锁定为纯色 - 设置 EnableSolidToGradientSwitch="False"，以禁止切换到渐变模式。

关键属性

属性类型用途
ColorColor获取或设置所选纯色
BrushBrush获取或设置所选渐变或纯色画刷
IsAlphaVisiblebool显示／隐藏 Alpha（不透明度）控件
IsColorPaletteVisiblebool显示／隐藏内置调色板
EnableSolidToGradientSwitchbool允许／禁止在不同模式间切换
GradientBrushDisplayModeenum设置显示模式（Default 或 Extended）

关键事件

事件触发时机
ColorChanged所选纯色发生变化时
SelectedBrushChanged所选画刷（渐变）发生变化时

依赖项

  • 程序集： Syncfusion.Shared.WPF
  • 框架： .NET Framework 4.5+
  • 依赖项： Syncfusion WPF 共享组件

评论

支持 Markdown