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

RadColorDialog

Class

Represents a dialog that can be used to select color with rich UI and extended functionality.

Definition

Assembly:Telerik.WinControls.dll

Syntax:

[TelerikToolboxCategory("Dialogs")]
public class RadColorDialog : CommonDialog, IComponent, IDisposable

Inheritance: objectMarshalByRefObjectComponentCommonDialogRadColorDialog

Implements: IComponentIDisposable

Constructors

RadColorDialog()

Initializes a new instance of the RadColorDialog class.

public RadColorDialog()

Properties

ColorDialogForm

IRadColorDialog

Gets the instance of IRadColorDialog, which incorporates various settings of the underlying color selection Form and ColorSelector user control.

[Browsable(false)]
public IRadColorDialog ColorDialogForm { get; }

CustomColors

Color[]

Gets the user-defined colors. References to CustomColors of ColorDialogForm.

[Browsable(false)]
public Color[] CustomColors { get; }

Icon

Gets or sets the icon displayed for this dialog.

public Icon Icon { get; set; }

OldColor

Color

Gets or sets the selected color that was previously selected. References to OldColor of ColorDialogForm.

public Color OldColor { get; set; }

RightToLeft

Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.

public virtual RightToLeft RightToLeft { get; set; }

Property Value:

One of the RightToLeft values. The default is Inherit.

Exceptions: InvalidEnumArgumentException

The assigned value is not one of the RightToLeft values.

SelectedColor

Color

Gets or sets the selected color. References to SelectedColor of ColorDialogForm.

public Color SelectedColor { get; set; }

SelectedHslColor

HslColor

Gets or sets the selected HSL color. References to SelectedHslColor of ColorDialogForm.

public HslColor SelectedHslColor { get; set; }

Methods

Dispose(bool)

Releases the unmanaged resources used by the RadColorDialog and optionally releases the managed resources.

protected override void Dispose(bool disposing)

Parameters:disposingbool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Overrides: Component.Dispose(bool)

Reset()

Resets the properties of a color dialog box to their default values. Replaces the underlying ColorDialogForm with new instance.

public override void Reset()

Overrides: CommonDialog.Reset()

RunDialog(IntPtr)

Shows the modal dialog box with the specified owner.

protected override bool RunDialog(IntPtr hwndOwner)

Parameters:hwndOwnerIntPtr

A value that represents the window handle of the owner window for the common dialog box.

Returns:

bool

true if the dialog box was successfully run and the user clicked OK; otherwise, false.

Overrides: CommonDialog.RunDialog(IntPtr)