Class RadColorEditor

The RadColorEditor control is an editor that allows you to select a custom color. It supports several color schemas: RGB, HLS, HSV, CMYK and HEX.

Inheritance
System.Object
RadColorEditor
Namespace: Telerik.Windows.Controls
Assembly: Telerik.Windows.Controls.Input.dll

Syntax

[TelerikToolboxCategory("Input")]
[Themable]
public class RadColorEditor : Control, IThemable

Constructors

RadColorEditor()

Initializes a new instance of the RadColorEditor class.

Declaration
public RadColorEditor()

Fields

ActiveSectionsProperty

Identifies the ActiveSections dependency property.

Declaration
public static readonly DependencyProperty ActiveSectionsProperty
Field Value
System.Windows.DependencyProperty

AlphaSettingsVisibilityProperty

Identifies the AlphaSettingsVisibility dependency property.

Declaration
public static readonly DependencyProperty AlphaSettingsVisibilityProperty
Field Value
System.Windows.DependencyProperty

ColorModeChangedEvent

Identifies the ColorModeChanged routed event.

Declaration
public static readonly RoutedEvent ColorModeChangedEvent
Field Value
System.Windows.RoutedEvent

ColorModeProperty

Identifies the ColorMode dependency property.

Declaration
public static readonly DependencyProperty ColorModeProperty
Field Value
System.Windows.DependencyProperty

ColorSettingsPanelWidthProperty

Identifies the Telerik.Windows.Controls.RadColorEditor.ColorSettingsPanelWidth dependency property.

Declaration
public static readonly DependencyProperty ColorSettingsPanelWidthProperty
Field Value
System.Windows.DependencyProperty

HistoryCapacityProperty

Identifies the HistoryCapacity dependency property.

Declaration
public static readonly DependencyProperty HistoryCapacityProperty
Field Value
System.Windows.DependencyProperty

HistoryChangedEvent

Identifies the HistoryChanged routed event.

Declaration
public static readonly RoutedEvent HistoryChangedEvent
Field Value
System.Windows.RoutedEvent

InitialColorProperty

Identifies the InitialColor dependency property.

Declaration
public static readonly DependencyProperty InitialColorProperty
Field Value
System.Windows.DependencyProperty

PreviousColorChangedEvent

Identifies the PreviousColorChanged routed event.

Declaration
public static readonly RoutedEvent PreviousColorChangedEvent
Field Value
System.Windows.RoutedEvent

PreviousColorProperty

Identifies the PreviousColor dependency property.

Declaration
public static readonly DependencyProperty PreviousColorProperty
Field Value
System.Windows.DependencyProperty

SelectedColorChangedEvent

Identifies the SelectedColorChanged routed event.

Declaration
public static readonly RoutedEvent SelectedColorChangedEvent
Field Value
System.Windows.RoutedEvent

SelectedColorChangingEvent

Identifies the SelectedColorChanging routed event.

Declaration
public static readonly RoutedEvent SelectedColorChangingEvent
Field Value
System.Windows.RoutedEvent

SelectedColorProperty

Identifies the SelectedColor dependency property.

Declaration
public static readonly DependencyProperty SelectedColorProperty
Field Value
System.Windows.DependencyProperty

UnifiedColorProperty

Identifies the UnifiedColor dependency property.

Declaration
public static readonly DependencyProperty UnifiedColorProperty
Field Value
System.Windows.DependencyProperty

ViewModelProperty

Identifies the ViewModel dependency property.

Declaration
public static readonly DependencyProperty ViewModelProperty
Field Value
System.Windows.DependencyProperty

Properties

ActiveSections

Gets or sets the active sections.

Declaration
public ActiveSectionTypes ActiveSections { get; set; }
Property Value
ActiveSectionTypes

AlphaSettingsVisibility

Gets or sets the AlphaSettingsVisibility. Hides or shows the Alpha Channel TextBox and Slider.

Declaration
public Visibility AlphaSettingsVisibility { get; set; }
Property Value
System.Windows.Visibility

ColorConverter

Gets or sets the color converter used by RadColorEditor.

Declaration
public static ColorConverter ColorConverter { get; set; }
Property Value
ColorConverter

The color converter.

ColorHistory

Provides a collection of previously selected colors.

Declaration
public ObservableCollection<Color> ColorHistory { get; }
Property Value
System.Collections.ObjectModel.ObservableCollection<System.Windows.Media.Color>

ColorMode

Gets or sets the ColorMode property. The ColorMode property determines which will be the current color scheme - RGB, HLS, HSV or CMYK.

Declaration
public ColorMode ColorMode { get; set; }
Property Value
ColorMode

ColorSettingsPanelWidth

Gets or sets the color settings panel width.

Declaration
public double ColorSettingsPanelWidth { get; set; }
Property Value
System.Double

HistoryCapacity

Gets or sets the HistoryCapacity property.

Declaration
public int HistoryCapacity { get; set; }
Property Value
System.Int32

InitialColor

Gets or sets the initial color.

Declaration
public Color InitialColor { get; set; }
Property Value
System.Windows.Media.Color

PreviousColor

Gets or sets the previously used color.

Declaration
public Color PreviousColor { get; set; }
Property Value
System.Windows.Media.Color

SelectedColor

Gets or sets the currently selected color.

Declaration
public Color SelectedColor { get; set; }
Property Value
System.Windows.Media.Color

UnifiedColor

Gets or sets the UnifiedColor property.

Declaration
public UnifiedColor UnifiedColor { get; set; }
Property Value
UnifiedColor

ViewModel

Gets or sets the view model.

Declaration
public UnifiedColorViewModel ViewModel { get; }
Property Value
UnifiedColorViewModel

The view model.

Methods

AddToHistory(Color)

Adds a System.Windows.Media.Color to RadColorEditor's color history.

Declaration
protected virtual void AddToHistory(Color color)
Parameters
System.Windows.Media.Color color

ChangeVisualState()

Changes the visual state of the control using transitions.

Declaration
protected virtual void ChangeVisualState()

ChangeVisualState(Boolean)

Updates the visual state of the control.

Declaration
protected virtual void ChangeVisualState(bool useTransitions)
Parameters
System.Boolean useTransitions

Indicates whether transitions should be used.

OnApplyTemplate()

When overridden in a derived class, is invoked whenever application code or internal processes (such as a rebuilding layout pass) call System.Windows.Controls.Control.ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in an application. For more information, see Remarks.

Declaration
public override void OnApplyTemplate()

OnColorModeChanged(ColorMode, ColorMode)

Called when the ColorMode property changes.

Declaration
protected virtual void OnColorModeChanged(ColorMode oldValue, ColorMode newValue)
Parameters
ColorMode oldValue

ColorMode newValue

OnCreateAutomationPeer()

Declaration
protected override AutomationPeer OnCreateAutomationPeer()
Returns
System.Windows.Automation.Peers.AutomationPeer

OnHistoryCapacityChanged(Int32, Int32)

Declaration
protected virtual void OnHistoryCapacityChanged(int oldValue, int newValue)
Parameters
System.Int32 oldValue

System.Int32 newValue

OnInitialized(EventArgs)

Raises the System.Windows.FrameworkElement.Initialized event. This method is invoked whenever System.Windows.FrameworkElement.IsInitialized is set to true internally.

Declaration
protected override void OnInitialized(EventArgs e)
Parameters
System.EventArgs e

The System.Windows.RoutedEventArgs that contains the event data.

OnPreviousColorChanged(Color, Color)

Called when the PreviousColor property changes.

Declaration
protected virtual void OnPreviousColorChanged(Color oldValue, Color newValue)
Parameters
System.Windows.Media.Color oldValue

System.Windows.Media.Color newValue

OnSelectedColorChanged(Color, Color)

Called when the SelectedColor property changes.

Declaration
protected virtual void OnSelectedColorChanged(Color oldValue, Color newValue)
Parameters
System.Windows.Media.Color oldValue

System.Windows.Media.Color newValue

OnUnifiedColorChanged(UnifiedColor, UnifiedColor)

Called when the UnifiedColor property changes.

Declaration
protected virtual void OnUnifiedColorChanged(UnifiedColor oldValue, UnifiedColor newValue)
Parameters
UnifiedColor oldValue

UnifiedColor newValue

RaiseColorModeChanged(ColorMode, ColorMode)

Raises the ColorModeChanged event.

Declaration
protected virtual void RaiseColorModeChanged(ColorMode oldValue, ColorMode newValue)
Parameters
ColorMode oldValue

The old ColorMode value.
ColorMode newValue

The new ColorMode value.

RaiseHistoryChanged(IList<Color>, IList<Color>)

Raises the HistoryChanged event.

Declaration
protected virtual void RaiseHistoryChanged(IList<Color> removedItems, IList<Color> addedItems)
Parameters
System.Collections.Generic.IList<System.Windows.Media.Color> removedItems

The removed items.
System.Collections.Generic.IList<System.Windows.Media.Color> addedItems

The added items.

RaisePreviousColorChanged(Color)

Raises the SelectedColorChanging event.

Declaration
protected virtual void RaisePreviousColorChanged(Color color)
Parameters
System.Windows.Media.Color color

The selected color.

RaiseSelectedColorChanged(Color)

Raises the SelectedColorChanged event.

Declaration
protected virtual void RaiseSelectedColorChanged(Color color)
Parameters
System.Windows.Media.Color color

The selected color.

RaiseSelectedColorChanging(Color)

Raises the SelectedColorChanging event.

Declaration
protected virtual void RaiseSelectedColorChanging(Color color)
Parameters
System.Windows.Media.Color color

The selected color.

ResetTheme()

Resets the theme.

Declaration
public void ResetTheme()

Events

ColorModeChanged

Occurs when the ColorMode property changes.

Declaration
public event EventHandler<ColorModeEventArgs> ColorModeChanged
Event Type
System.EventHandler<ColorModeEventArgs>

HistoryChanged

Occurs when ColorHistory property changes.

Declaration
public event EventHandler<HistoryChangedEventArgs> HistoryChanged
Event Type
System.EventHandler<HistoryChangedEventArgs>

PreviousColorChanged

Occurs when the PreviousColor property has changed its value.

Declaration
public event EventHandler<ColorChangeEventArgs> PreviousColorChanged
Event Type
System.EventHandler<ColorChangeEventArgs>

SelectedColorChanged

Occurs when the SelectedColor property has changed its value.

Declaration
public event EventHandler<ColorChangeEventArgs> SelectedColorChanged
Event Type
System.EventHandler<ColorChangeEventArgs>

SelectedColorChanging

Occurs when the SelectedColor property is changing its value.

Declaration
public event EventHandler<ColorChangeEventArgs> SelectedColorChanging
Event Type
System.EventHandler<ColorChangeEventArgs>

Extension Methods