TdxChartPaletteRepository.CreateItem Method

Creates an empty user palette with the default settings.

Declaration

function CreateItem: TdxChartUserPalette; overload;

Returns

Type	Description
TdxChartUserPalette	The created empty user palette.

Remarks

Call the CreateItem function to create an empty user palette with an automatically generated name.

Code Example: Create and Populate a User Palette

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

Delphi

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;

C++

  // ...
  TdxChartUserPalette *AChartPalette;
  // ...
  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(TdxAlphaColors::Red);
  AChartPalette->Items[1] = TdxChartPaletteItem(TdxAlphaColors::Green);
  AChartPalette->Items[2] = TdxChartPaletteItem(TdxAlphaColors::Blue);
  dxChartControl1->Palette = AChartPalette;