Skip to main content
All docs
V24.2

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TdxCustomChartControl.Palette Property

Specifies the palette applied to Chart control content.

#Declaration

Delphi
property Palette: TdxChartPalette read; write;

#Property Value

Type Description
TdxChartPalette

The active standard or custom chart palette.

You can assign nil (in Delphi) or nullptr (in C++Builder) to apply the default palette to the Chart control.

#Remarks

Use the Palette property to apply a predefined or custom palette to the Chart control.

VCL Chart Control: Predefined Palette Examples

If the active palette does not have enough explicitly defined colors to draw all affected series or series values differently, the Chart control generates interpolated colors based on existing colors.

#Design-Time Palette Selection

You can click the drop-down button for the Palette property in the Object Inspector and select any palette in the displayed list.

VCL Chart Control: Apply a User Palette in the Object Inspector

The palette list includes all predefined and custom palettes.

#Code Examples

#Assign a Predefined Palette

The following code example applies the predefined palette Nature Colors to the Chart control:

  dxChartControl1.Palette := TdxChartStandardPaletteRepository.FindPalette('Nature Colors');

#Create and Assign a Custom Palette

The following code example creates a user palette with three colors and applies the palette to a Chart control:

var
  AChartPalette: TdxChartUserPalette;
begin
  AChartPalette := dxChartPaletteRepository1.CreateItem;
  AChartPalette.Name := 'My Palette 1'; // Assigns a unique palette name
  AChartPalette.Count := 3;  // Sets the size of the palette item array
  AChartPalette.Items[0] := TdxChartPaletteItem.Create(TdxAlphaColors.Red);
  AChartPalette.Items[1] := TdxChartPaletteItem.Create(TdxAlphaColors.Green);
  AChartPalette.Items[2] := TdxChartPaletteItem.Create(TdxAlphaColors.Blue);
  dxChartControl1.Palette := AChartPalette;
end;

VCL Chart Control: A Simple Custom Palette Example

#Default Value

The Palette property’s default value is TdxChartStandardPaletteRepository.Default.

See Also