New to Telerik UI for WPF? Download free 30-day trial

Getting Started

This article will help you get started with the Telerik RadColorEditor control

Assembly References

In order to use the RadColorEditor in your projects you have to add references to the following assemblies:

  • Telerik.Windows.Controls
  • Telerik.Windows.Controls.Input You can find more info here.

Adding RadColorEditor to the Project

You can add RadColorEditor manually by writing the XAML code in Example 1. You can also add the control by dragging it from the Visual Studio Toolbox and dropping it over the XAML view.

Example 1: Adding RadColorEditor in XAML

<Grid> 
    <telerik:RadColorEditor x:Name="colorEditor" /> 
</Grid> 

Selection

The RadColorEditor is a control that displays a custom palette from which users can select a single color. The control exposes a SelectedColor property, which is of type Color and is used to store the selected color value.

Example 2: Setting the SelectedColor property

<telerik:RadColorEditor SelectedColor="Red" /> 

Example 2: Setting the SelectedColor property in code behind

RadColorEditor colorEditor = new RadColorEditor(); 
colorEditor.SelectedColor = Colors.Red; 
Dim colorEditor As New RadColorEditor() 
colorEditor.SelectedColor = Colors.Red 

Whenever a color is selected the SelectedColorChanged event is raised:

Example 3: Subscribing to SelectedColorChanged event

<telerik:RadColorEditor x:Name="colorEditor" SelectedColorChanged="colorEditor_SelectedColorChanged " /> 

Example 4: Subscribing to SelectedColorChanged event in code behind

colorEditor.SelectedColorChanged += new EventHandler<ColorChangeEventArgs>(colorEditor_SelectedColorChanged); 
 
private void colorEditor1_SelectedColorChanged(object sender, ColorChangeEventArgs e) 
{ 
   Color selectedColor = e.Color; 
} 
colorEditor.SelectedColorChanged += New EventHandler(Of ColorChangeEventArgs)(colorEditor_SelectedColorChanged) 
 
Private Sub colorEditor1_SelectedColorChanged(ByVal sender As Object, ByVal e As ColorChangeEventArgs) 
    Dim selectedColor As Color = e.Color 
End Sub 

Set Color Settings Panel Width

Since the 2021 R3 release, RadColorEditor exposes the ColorSettingsPanelWidth property for setting the width of the color settings panel area.

Example 5: Setting the ColorSettingsPanelWidth property

<telerik:RadColorEditor x:Name="colorEditor" ColorSettingsPanelWidth="450" /> 

Setting a Theme

The controls from our suite support different themes. You can see how to apply a theme different than the default one in the Setting a Theme help article.

Changing the theme using implicit styles will affect all controls that have styles defined in the merged resource dictionaries. This is applicable only for the controls in the scope in which the resources are merged.

To change the theme, you can follow the steps below:

  • Choose between the themes and add reference to the corresponding theme assembly (ex: Telerik.Windows.Themes.Windows8.dll). You can see the different themes applied in the Theming examples from our WPF Controls Examples application.

  • Merge the ResourceDictionaries with the namespace required for the controls that you are using from the theme assembly. For the RadColorEditor, you will need to merge the following resources:

    • Telerik.Windows.Controls
    • Telerik.Windows.Controls.Input

Example 6 demonstrates how to merge the ResourceDictionaries so that they are applied globally for the entire application.

Example 6: Merge the ResourceDictionaries

<Application.Resources> 
    <ResourceDictionary> 
        <ResourceDictionary.MergedDictionaries> 
            <ResourceDictionary Source="/Telerik.Windows.Themes.Windows8;component/Themes/System.Windows.xaml"/> 
            <ResourceDictionary Source="/Telerik.Windows.Themes.Windows8;component/Themes/Telerik.Windows.Controls.xaml"/> 
            <ResourceDictionary Source="/Telerik.Windows.Themes.Windows8;component/Themes/Telerik.Windows.Controls.Input.xaml"/> 
        </ResourceDictionary.MergedDictionaries> 
    </ResourceDictionary> 
</Application.Resources> 

Alternatively, you can use the theme of the control via the StyleManager.

Figure 4 shows a RadColorEditor with the Windows8 theme applied.

Figure 4: RadCalculator with the Windows8 theme

RadCalculator with Windows8 theme

See Also

In this article
Not finding the help you need? Improve this article