Skip to content

syncfusion/wpf-ui-components-skills / skills/syncfusion-wpf-colorpicker

syncfusion-wpf-colorpicker

Verified

Implement Syncfusion WPF ColorPicker for color and gradient selection. Use this skill whenever users need to add color picking functionality, select solid colors, create linear/radial gradients, customize palettes, apply themes, or handle color-changed events in WPF applications. Covers XAML and C# implementations.

references/getting-started.md

View on GitHub
# Getting Started with WPF ColorPicker

This guide covers setup, installation, and basic implementation of the Syncfusion WPF ColorPicker control.

## Assembly Dependencies

The ColorPicker requires the following assembly to function:
- **Syncfusion.Shared.WPF**

For NuGet installation, refer to [Syncfusion WPF NuGet packages documentation](https://help.syncfusion.com/wpf/visual-studio-integration/nuget-packages).

## Adding ColorPicker via Designer

The easiest way to add ColorPicker to your application:

1. Open your WPF project in Visual Studio
2. Open the Toolbox panel
3. Locate **ColorPicker** under Syncfusion controls
4. Drag and drop it onto your designer view
5. The required assembly (Syncfusion.Shared.WPF) will be added automatically

![WPF Color Picker Drag and dropped from ToolBox](../../../../../../../docs/Getting-Started.md)

## Adding ColorPicker via XAML

To manually add ColorPicker in XAML:

### Step 1: Create a New WPF Project
Create a new WPF application in Visual Studio.

### Step 2: Add Assembly Reference
Add the Syncfusion.Shared.WPF assembly to your project references.

### Step 3: Import Syncfusion Schema
In your XAML file, import the Syncfusion WPF schema:
```xaml
xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
```

### Step 4: Declare ColorPicker
```xaml
<Window x:Class="ColorPickerSample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:syncfusion="http://schemas.syncfusion.com/wpf"
        Title="ColorPicker Sample" Height="450" Width="800">
    <Grid Name="grid">
        <syncfusion:ColorPicker Name="colorPicker" 
                                Height="100" 
                                Width="280"/>
    </Grid>
</Window>
```

This creates a basic ColorPicker control with default settings (solid color mode, color palette visible, alpha channel visible).

## Adding ColorPicker via C#

To add ColorPicker programmatically in C#:

### Step 1: Include Required Namespace
```csharp
using Syncfusion.Windows.Shared;
```

### Step 2: Create and Configure
```csharp
ColorPicker colorPicker = new ColorPicker();
colorPicker.Width = 300;
colorPicker.Height = 100;

// Add to your container (Grid, StackPanel, etc.)
grid.Children.Add(colorPicker);
```

## Control Structure

The ColorPicker consists of the following main components:

- **Color Picker Region** - Interactive area to select hue and saturation by dragging
- **Hue Spectrum Slider** - Vertical slider for hue value selection
- **Value Inputs** - RGB, HSV, or Hex value editors (depending on active tab)
- **Alpha Slider** - Horizontal slider for opacity control (if IsAlphaVisible is True)
- **Color Palette Dropdown** - Built-in color palette for quick selection (if IsColorPaletteVisible is True)
- **Brush Mode Buttons** - Buttons to switch between Solid, Linear Gradient, and Radial Gradient modes (if EnableSolidToGradientSwitch is True)

## Basic Configuration

### Set Initial Color
```xaml
<syncfusion:ColorPicker Color="Yellow"/>
```

Or in C#:
```csharp
colorPicker.Color = Colors.Yellow;
```

### Control Visibility of Components

Set `IsAlphaVisible="False"` to hide the alpha channel, `IsColorPaletteVisible="False"` to hide the color palette, or `EnableSolidToGradientSwitch="False"` to hide brush mode switching buttons in XAML or C#.

### Set Dimensions
```csharp
colorPicker.Width = 400;
colorPicker.Height = 350;
```

## Common Configuration Combinations

**Minimal (Solid Colors Only)** - Set `IsColorPaletteVisible="True"`, `IsAlphaVisible="False"`, `EnableSolidToGradientSwitch="False"` for simple solid color selection.

**Full-Featured** - Set `IsColorPaletteVisible="True"`, `IsAlphaVisible="True"`, `EnableSolidToGradientSwitch="True"` for complete color and gradient selection.

**Compact (No Palette)** - Set `IsColorPaletteVisible="False"` and small dimensions (`Width="200"`, `Height="150"`) for space-constrained layouts.

## Verify Installation

Add a ColorPicker control to your window and run the application. You should see a colored square and controls. Verify that clicking the color area changes the color and you can adjust RGB/HSV/Hex values. If not visible, ensure Syncfusion.Shared.WPF is in project references, the correct schema URI is used, and the project builds without errors.

## Next Steps

- To select and work with colors: See **Solid and Gradient Colors** reference
- To customize behavior: See **Customization Options** reference
- To handle color changes: See **Events and Integration** reference
- To apply themes: See **Appearance and Theming** reference
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall