TColorDialog class

Declaration

TColorDialog = class(TCommonDialog)

Inheritance

1. TColorDialog
2. TCommonDialog
3. TLCLComponent
4. TComponent

Description

TColorDialog is a TCommonDialog descendant which implements a dialog used to select a color value from a palette of colors. It is a wrapper for the native color selection dialog on platforms supported by the LCL (when available).

The dialog allows a TColor value to be selected from a group of predefined basic colors, custom colors, or using a color wheel or pad. On some platforms, the color can be specified using RGB or HSL (Hue, Saturation, Luminosity) values.

Use the CustomColors property to define color values using identifiers and hexadecimal RGB values for the custom colors.

Use the Options property to control the features enabled or disabled when the dialog is executed.

Set the value for the Title property (when needed) prior to displaying the color selection dialog.

Call the Execute method to display the color dialog and capture the color value. If the user clicks on the OK button in the dialog, the selected color value is returned in the Color property and the UserChoice property is set to mrOK. A value other than mrOK indicates that the color selection dialog was cancelled or closed without selecting a color value.

See also

• Color
• CustomColors
• Options
• AlphaChannel
• Title
• Execute
• UserChoice

Properties

Methods

Inherited