Edit this page

Working with the RadColorDialog


The significant properties unique to RadColorDialog are:

ActiveMode: Determines the currently selected tab.  Valid enumeration values from Telerik.WinControls.ColorPickerActiveMode are Basic, System, Web, Professional.

AllowColorPickFromScreen: When true (the default) the "eye dropper" tool is displayed.

forms-and-dialogs-colordialog-working-with-the-radcolordialog 001

AllowColorSaving: Toggles the "Add a custom color" button visibility.

forms-and-dialogs-colordialog-working-with-the-radcolordialog 002

BackColor: The background color of the color selector as a whole. You can also set this color to be Transparent to have it blend in with your other UI elements.

ForeColor: The color for labels and text entry.

SelectedColor: In the figure below the SelectedColor is labeled as "New".

OldColor: In the figure below the OldColor is labeled as "Current".

forms-and-dialogs-colordialog-working-with-the-radcolordialog 003

ShowBasicColors, ShowSystemColors, ShowWebColors, ShowProfessionalColors: If true (the default) the corresponding Basic, System, Web and Professional tabs are displayed.

AllowEditHEXValue: If true (the default) enables hexadecimal entry of color values.

ShowHEXColorValue: If true (the default) displays the hexadecimal entry of color values.

forms-and-dialogs-colordialog-working-with-the-radcolordialog 004

CustomColors[]: This is a read-only array of Color objects.  You can query the contents of the custom colors displayed along the bottom of the selector.

forms-and-dialogs-colordialog-working-with-the-radcolordialog 005

Enlist the current custom colors in RadColorDialog

private void radButton1_Click(object sender, EventArgs e)
    StringBuilder sb = new StringBuilder();
    foreach (Color color in radColorDialog1.CustomColors)

Private Sub RadButton1_Click_1(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles RadButton1.Click
    Dim sb As New StringBuilder()
    For Each color As Color In RadColorDialog1.CustomColors
End Sub

Localization/Internationalization Properties: The text values of the RadColorDialog can be customized for easy localization including properties AddNewColorButtonText, BasicTabHeading, SystemTabHeading, WebTabHeading, ProfessionalTabHeading, SelectedColorLabelHeading and OldColorLabelHeading.

Getting the selected colors

In order go get the SelectedColor or the SelectedHlsColor you can use the following code snippet:

Enlist the current custom colors in RadColorDialog

if (radColorDialog1.ShowDialog() == DialogResult.OK)
    Color color = radColorDialog1.SelectedColor;
    HslColor hslColor = radColorDialog1.SelectedHslColor;

If RadColorDialog1.ShowDialog() = DialogResult.OK Then
    Dim color As Color = RadColorDialog1.SelectedColor
    Dim hslColor As Telerik.WinControls.HslColor = RadColorDialog1.SelectedHslColor
End If