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

TdxChartUserPalette.Name Property

The user palette name.

#Declaration

Delphi
property Name: string read; write;

#Property Value

Type Description
string

The name of the user palette.

#Remarks

Use the Name property to specify a name for the user palette.

All standard and user palette names are unique. An exception occurs if you assign a name that matches the name of an existing standard palette or another palette stored in the repository component accessible through the Repository property.

#Code Example: Create a User 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

See Also