New to Telerik UI for WinForms? Start a free 30-day trial

Represents a dialog form containing a color picker with rich functionality for color selection.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class RadColorDialogForm : RadForm, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, IComponentTreeHandler, ILayoutHandler, ISupportInitializeNotification, ISupportInitialize, INotifyPropertyChanged, IAnalyticsProvider, ISupportRootUIAutomation, IRadColorDialog

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlFormRadFormControlBaseRadFormRadColorDialogForm...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIContainerControlIDisposableIDropTargetILayoutHandlerINotifyPropertyChangedIRadColorDialogISupportInitializeISupportInitializeNotificationISupportRootUIAutomationISynchronizeInvokeIWin32Window...

Inherited Members RadForm.ScrollToControl(Control)RadForm.EndInit()RadForm.WndProc(ref Message)RadForm.ProcessCaptureChangeRequested(RadElement, bool)RadForm.InitializeFormBehavior()RadForm.SetIconPrimitiveVisibility(bool)RadForm.EnableUIAutomationRadForm.TextRadForm.ThemeClassNameRadForm.FormElementRadForm.IconScalingRadForm.AllowThemingRadForm.ShowIconRadFormControlBase.newBoundsRadFormControlBase.oldDpiRadFormControlBase.currentDpiRadFormControlBase.isBehaviorPreparedRadFormControlBase.controlIsInitializingRootComponentRadFormControlBase.isPaintingRadFormControlBase.Construct()RadFormControlBase.OnCreateControl()RadFormControlBase.LoadElementTree()RadFormControlBase.LoadElementTree(Size)RadFormControlBase.OnLoad(Size)RadFormControlBase.OnShown(EventArgs)RadFormControlBase.OnPaint(PaintEventArgs)RadFormControlBase.OnPaintBackground(PaintEventArgs)RadFormControlBase.ProcessDialogKey(Keys)RadFormControlBase.UpdateDefaultButton()RadFormControlBase.OnBackColorChanged(EventArgs)RadFormControlBase.OnForeColorChanged(EventArgs)RadFormControlBase.OnFontChanged(EventArgs)RadFormControlBase.OnParentChanged(EventArgs)RadFormControlBase.ShouldSerializeProperty(RadProperty)RadFormControlBase.ResetFormBehavior(bool)RadFormControlBase.PerformDesignModeLocationCorrection(ref Message)RadFormControlBase.CallBaseWndProc(ref Message)RadFormControlBase.ProcessFocusRequested(RadElement)RadFormControlBase.OnNotifyPropertyChanged(string)RadFormControlBase.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadFormControlBase.CreateChildItems(RadElement)RadFormControlBase.CreateRootElement()RadFormControlBase.OnThemeNameChanged(ThemeNameChangedEventArgs)RadFormControlBase.OnThemeChanged()RadFormControlBase.OnDisplayPropertyChanged(RadPropertyChangedEventArgs)RadFormControlBase.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadFormControlBase.OnHandleCreated(EventArgs)RadFormControlBase.OnVisibleChanged(EventArgs)RadFormControlBase.OnAutoSizeChanged(EventArgs)RadFormControlBase.OnLayout(LayoutEventArgs)RadFormControlBase.CreateHandle()RadFormControlBase.SetClientSizeCore(int, int)RadFormControlBase.SetBoundsCore(int, int, int, int, BoundsSpecified)RadFormControlBase.GetPreferredSize(Size)RadFormControlBase.InvalidateIfNotSuspended()RadFormControlBase.InvalidateElement(RadElement)RadFormControlBase.InvalidateElement(RadElement, Rectangle)RadFormControlBase.AddInvalidatedRect(Rectangle)RadFormControlBase.SuspendUpdate()RadFormControlBase.ResumeUpdate()RadFormControlBase.ResumeUpdate(bool)RadFormControlBase.RegisterHostedControl(RadHostItem)RadFormControlBase.UnregisterHostedControl(RadHostItem, bool)RadFormControlBase.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadFormControlBase.ControlThemeChangedCallback()RadFormControlBase.InvokeLayoutCallback(LayoutCallback)RadFormControlBase.BeginInit()RadFormControlBase.HandleDpiChanged()RadFormControlBase.ScaleControl(SizeF, BoundsSpecified)RadFormControlBase.SuspendDpiScaling()RadFormControlBase.ResumeDpiScaling()RadFormControlBase.OnWm_SettingChange(Message)RadFormControlBase.SiteRadFormControlBase.EnableAnalyticsRadFormControlBase.IsLoadedRadFormControlBase.MaximumSizeRadFormControlBase.MinimumSizeRadFormControlBase.FormBorderStyleRadFormControlBase.FormBehaviorRadFormControlBase.BehaviorRadFormControlBase.SmallImageListRadFormControlBase.FocusedElementRadFormControlBase.AllowShowFocusCuesRadFormControlBase.ShowItemToolTipsRadFormControlBase.CommandBindingsRadFormControlBase.EnableKeyMapRadFormControlBase.WindowsSettingsRadFormControlBase.BackColorRadFormControlBase.ForeColorRadFormControlBase.FontRadFormControlBase.CreateParamsRadFormControlBase.IsDesignModeRadFormControlBase.ElementTreeRadFormControlBase.ThemeNameRadFormControlBase.RootElementRadFormControlBase.IsUpdateSuspendedRadFormControlBase.ImageListRadFormControlBase.SmallImageScalingSizeRadFormControlBase.ImageScalingSizeRadFormControlBase.IsInitializedRadFormControlBase.IsPerformingScaleRadFormControlBase.HasOwnToolbarRadFormControlBase.IsDpiScalingSuspendedRadFormControlBase.ThemeNameChangedRadFormControlBase.ToolTipTextNeededRadFormControlBase.ScreenTipNeededRadFormControlBase.InitializedRadFormControlBase.PropertyChangedRadFormControlBase.WindowsThemeChangedForm.SetVisibleCore(bool)Form.Activate()Form.ActivateMdiChild(Form)Form.AddOwnedForm(Form)Form.AdjustFormScrollbars(bool)Form.Close()Form.CreateControlsInstance()Form.DefWndProc(ref Message)Form.ProcessMnemonic(char)Form.CenterToParent()Form.CenterToScreen()Form.LayoutMdi(MdiLayout)Form.OnActivated(EventArgs)Form.OnBackgroundImageChanged(EventArgs)Form.OnBackgroundImageLayoutChanged(EventArgs)Form.OnClosing(CancelEventArgs)Form.OnClosed(EventArgs)Form.OnFormClosing(FormClosingEventArgs)Form.OnFormClosed(FormClosedEventArgs)Form.OnDeactivate(EventArgs)Form.OnEnabledChanged(EventArgs)Form.OnEnter(EventArgs)Form.OnHandleDestroyed(EventArgs)Form.OnHelpButtonClicked(CancelEventArgs)Form.OnMaximizedBoundsChanged(EventArgs)Form.OnMaximumSizeChanged(EventArgs)Form.OnMinimumSizeChanged(EventArgs)Form.OnInputLanguageChanged(InputLanguageChangedEventArgs)Form.OnInputLanguageChanging(InputLanguageChangingEventArgs)Form.OnMdiChildActivate(EventArgs)Form.OnMenuStart(EventArgs)Form.OnMenuComplete(EventArgs)Form.OnResize(EventArgs)Form.OnDpiChanged(DpiChangedEventArgs)Form.OnGetDpiScaledSize(int, int, ref Size)Form.OnRightToLeftLayoutChanged(EventArgs)Form.OnTextChanged(EventArgs)Form.ProcessDialogChar(char)Form.ProcessKeyPreview(ref Message)Form.ProcessTabKey(bool)Form.RemoveOwnedForm(Form)Form.Select(bool, bool)Form.GetScaledBounds(Rectangle, SizeF, BoundsSpecified)Form.SetDesktopBounds(int, int, int, int)Form.SetDesktopLocation(int, int)Form.Show(IWin32Window)Form.ShowDialog()Form.ShowDialog(IWin32Window)Form.ToString()Form.OnResizeBegin(EventArgs)Form.OnResizeEnd(EventArgs)Form.OnStyleChanged(EventArgs)Form.ValidateChildren()Form.ValidateChildren(ValidationConstraints)Form.AcceptButtonForm.ActiveFormForm.ActiveMdiChildForm.AllowTransparencyForm.AutoScrollForm.AutoSizeForm.AutoSizeModeForm.AutoValidateForm.CancelButtonForm.ClientSizeForm.ControlBoxForm.DefaultImeModeForm.DefaultSizeForm.DesktopBoundsForm.DesktopLocationForm.DialogResultForm.HelpButtonForm.IconForm.IsMdiChildForm.IsMdiContainerForm.IsRestrictedWindowForm.KeyPreviewForm.LocationForm.MaximizedBoundsForm.MainMenuStripForm.MenuForm.MaximizeBoxForm.MdiChildrenForm.MdiParentForm.MergedMenuForm.MinimizeBoxForm.ModalForm.OpacityForm.OwnedFormsForm.OwnerForm.RestoreBoundsForm.RightToLeftLayoutForm.ShowInTaskbarForm.ShowWithoutActivationForm.SizeForm.SizeGripStyleForm.StartPositionForm.TopLevelForm.TopMostForm.TransparencyKeyForm.WindowStateForm.AutoSizeChangedForm.AutoValidateChangedForm.HelpButtonClickedForm.MaximizedBoundsChangedForm.MaximumSizeChangedForm.MinimumSizeChangedForm.ActivatedForm.DeactivateForm.FormClosingForm.FormClosedForm.LoadForm.MdiChildActivateForm.MenuCompleteForm.MenuStartForm.InputLanguageChangedForm.InputLanguageChangingForm.RightToLeftLayoutChangedForm.ShownForm.DpiChangedForm.ResizeBeginForm.ResizeEnd...

Constructors

Initializes a new instance of the RadColorDialogForm class.

C#
public RadColorDialogForm()

Properties

Gets or sets the active mode of the color picker, determining which tab is currently displayed.

C#
public ColorPickerActiveMode ActiveMode { get; set; }

Implements: IRadColorDialog.ActiveMode

Gets or sets a value indicating whether users can pick colors from the screen using an eyedropper tool.

C#
public bool AllowColorPickFromScreen { get; set; }

Implements: IRadColorDialog.AllowColorPickFromScreen

Gets or sets a value indicating whether users can save colors to the custom colors collection.

C#
public bool AllowColorSaving { get; set; }

Implements: IRadColorDialog.AllowColorSaving

Gets or sets a value indicating whether users can edit the hexadecimal color value directly.

C#
public bool AllowEditHEXValue { get; set; }

Implements: IRadColorDialog.AllowEditHEXValue

Gets or sets the heading text for the basic colors tab.

C#
public string BasicTabHeading { get; set; }

Implements: IRadColorDialog.BasicTabHeading

Gets an array of custom colors that have been saved by the user.

C#
public Color[] CustomColors { get; }

Implements: IRadColorDialog.CustomColors

Gets or sets the old color that was previously selected, used for comparison purposes.

C#
public Color OldColor { get; set; }

Implements: IRadColorDialog.OldColor

Gets or sets the heading text for the old color label.

C#
public string OldColorLabelHeading { get; set; }

Implements: IRadColorDialog.OldColorLabelHeading

Gets or sets the heading text for the professional colors tab.

C#
public string ProfessionalTabHeading { get; set; }

Implements: IRadColorDialog.ProfessionalTabHeading

Gets the color selector control as a UserControl.

C#
public UserControl RadColorSelector { get; }

Implements: IRadColorDialog.RadColorSelector

Gets or sets the currently selected color in the color picker.

C#
public Color SelectedColor { get; set; }

Implements: IRadColorDialog.SelectedColor

Gets or sets the heading text for the selected color label.

C#
public string SelectedColorLabelHeading { get; set; }

Implements: IRadColorDialog.SelectedColorLabelHeading

Gets or sets the currently selected color as an HslColor value.

C#
public HslColor SelectedHslColor { get; set; }

Implements: IRadColorDialog.SelectedHslColor

Gets or sets a value indicating whether the basic colors tab is visible.

C#
public bool ShowBasicColors { get; set; }

Implements: IRadColorDialog.ShowBasicColors

Gets or sets a value indicating whether the custom colors tab is visible.

C#
public bool ShowCustomColors { get; set; }

Implements: IRadColorDialog.ShowCustomColors

Gets or sets a value indicating whether the hexadecimal color value is displayed.

C#
public bool ShowHEXColorValue { get; set; }

Implements: IRadColorDialog.ShowHEXColorValue

Gets or sets a value indicating whether the professional colors tab is visible.

C#
public bool ShowProfessionalColors { get; set; }

Implements: IRadColorDialog.ShowProfessionalColors

Gets or sets a value indicating whether the system colors tab is visible.

C#
public bool ShowSystemColors { get; set; }

Implements: IRadColorDialog.ShowSystemColors

Gets or sets a value indicating whether the web colors tab is visible.

C#
public bool ShowWebColors { get; set; }

Implements: IRadColorDialog.ShowWebColors

Gets or sets the heading text for the system colors tab.

C#
public string SystemTabHeading { get; set; }

Implements: IRadColorDialog.SystemTabHeading

Gets or sets the heading text for the web colors tab.

C#
public string WebTabHeading { get; set; }

Implements: IRadColorDialog.WebTabHeading

Methods

Clean up any resources being used.

C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

true if managed resources should be disposed; otherwise, false.

Overrides: RadForm.Dispose(bool)

Raises the ColorChanged event.

C#
protected virtual void OnColorChanged(ColorChangedEventArgs e)
Parameters:eColorChangedEventArgs

A ColorChangedEventArgs that contains the event data.

Raises the Load event and performs additional initialization for specific themes.

C#
protected override void OnLoad(EventArgs e)
Parameters:eEventArgs

An EventArgs that contains the event data.

Overrides: RadForm.OnLoad(EventArgs)

Processes command keys to handle special keyboard input, such as the Enter key.

C#
protected override bool ProcessCmdKey(ref Message msg, Keys keyData)
Parameters:msgMessage

A Message, passed by reference, that represents the window message to process.

keyDataKeys

One of the Keys values that represents the key to process.

Returns:

bool

true if the command key was processed by this method; otherwise, false.

Overrides: Form.ProcessCmdKey(ref Message, Keys)

Events

Occurs when the selected color has changed.

C#
public event ColorChangedEventHandler ColorChanged

Implements: IRadColorDialog.ColorChanged