TdxChartPaletteItems Type

An array of chart palette items.

Declaration

TdxChartPaletteItems = array of TdxChartPaletteItem;

Referenced Class

Type	Description
TdxChartPaletteItem	A chart palette item.

Remarks

An array of chart palette items can be useful if you need to copy color sets between user palettes.

Code Example: Copy Standard Palette Colors to a User Palette

The following code example creates a custom palette based on one of the predefined palettes and applies the created palette to a Chart control:

Delphi

var
  AStandardPalette: TdxChartPalette;
  AChartPalette: TdxChartUserPalette;
  APaletteItems: TdxChartPaletteItems;  // A dynamic array of palette items used as a temporary container
  I: Integer;
begin
  AStandardPalette := TdxChartStandardPaletteRepository.FindPalette('Nature Colors');
  if AStandardPalette = nil then Exit;
  SetLength(APaletteItems, AStandardPalette.Count);
  // Copies all colors from the obtained color palette into the defined dynamic array
  for I := 0 to AStandardPalette.Count - 1 do
    APaletteItems[I] := AStandardPalette.Items[I];
  AChartPalette := dxChartPaletteRepository1.CreateItem('My Palette 1', APaletteItems);
  // Replaces the third palette item
  AChartPalette.Items[2] := TdxChartPaletteItem.Create(TdxAlphaColors.Red);
  // Adds a new palette item
  AChartPalette.Count := AChartPalette.Count + 1; // Increments the size of the palette item array
  AChartPalette.Items[AChartPalette.Count - 1] := TdxChartPaletteItem.Create(TdxAlphaColors.LightGreen);
  dxChartControl1.Palette := AChartPalette;  // Assigns the created palette to a TdxChartControl instance
end;

C++

  TdxChartPalette *AStandardPalette;
  TdxChartUserPalette *AChartPalette;
  TdxChartPaletteItems *APaletteItems; // A dynamic array of palette items used as a temporary container
  // ...
  AStandardPalette = TdxChartStandardPaletteRepository->FindPalette("Nature Colors");
  if (AStandardPalette == nullptr) { return; }
  SetLength(APaletteItems, AStandardPalette->Count);
  // Copies all colors from the obtained color palette into the defined dynamic array
  for(int i = 0; i < AStandardPalette->Count; i++)
    APaletteItems[i] = AStandardPalette->Items[i];
  AChartPalette = dxChartPaletteRepository1->CreateItem("My Palette 1", APaletteItems);
  // Replaces the third palette item
  AChartPalette->Items[2] = TdxChartPaletteItem(TdxAlphaColors::Red);
  // Adds a new palette item
  AChartPalette->Count = AChartPalette->Count + 1;  // Increments the size of the palette item array
  AChartPalette->Items[AChartPalette->Count - 1] = TdxChartPaletteItem(TdxAlphaColors::LightGreen);
  dxChartControl1->Palette = AChartPalette; // Assigns the created palette to a TdxChartControl instance

Direct TdxChartPaletteItems Type Reference

The TdxChartPaletteRepository.CreateItem function accepts a TdxChartPaletteItems array as the AColors parameter.