TdxChartSimpleSeriesPointDrawParameters Class

Stores series point draw settings in a simple series View.

Declaration

delphi

TdxChartSimpleSeriesPointDrawParameters = class(
    TdxChartSeriesPointDrawParameters
)

Remarks

The TdxChartBarSeriesPointDrawParameters class implements only the FillOptions property that allows you to change fill settings of individual points in a simple series.

Handle a simple diagram‘s OnGetSeriesPointDrawParameters event to change the appearance of individual series points based on certain conditions.

Code Example: Customize Pie Slice Appearance

The following code example demonstrates a diagram’s OnGetSeriesPointDrawParameters event handler that changes the appearance settings of the pie slice that shows the English language’s share:

Delphi
C++

delphi

procedure TMyForm.cdAreaGetSeriesPointDrawParameters(Sender: TdxChartCustomDiagram;
  AArgs: TdxChartGetSeriesPointDrawParametersEventArgs);
var
  ASimpleDrawParameters: TdxChartSimpleSeriesPointDrawParameters;
begin
  if AArgs.SeriesPoint.Argument = 'English' then
  begin
    if AArgs.DrawParameters.ClassType <> TdxChartSimpleSeriesPointDrawParameters then Exit;
    ASimpleDrawParameters := AArgs.DrawParameters as TdxChartSimpleSeriesPointDrawParameters;
    ASimpleDrawParameters.FillOptions.BeginUpdate;
    ASimpleDrawParameters.FillOptions.Color := TdxAlphaColors.LightCyan;
    ASimpleDrawParameters.FillOptions.Color2 := TdxAlphaColors.LightBlue;
    ASimpleDrawParameters.FillOptions.Mode := TdxFillOptionsMode.Hatch;
    ASimpleDrawParameters.FillOptions.HatchStyle := TdxFillOptionsHatchStyle.ForwardDiagonal;
    ASimpleDrawParameters.FillOptions.EndUpdate;
  end;
end;

cpp

void __fastcall TMyForm::cdAreaGetSeriesPointDrawParameters(TdxChartCustomDiagram *Sender
   TdxChartGetSeriesPointDrawParametersEventArgs *AArgs)
{
  TdxChartSimpleSeriesPointDrawParameters *ASimpleDrawParameters;
  // ...
  if(AArgs->SeriesPoint->Argument == "English")
  {
    if(AArgs->DrawParameters->ClassType() != __classid(TdxChartSimpleSeriesPointDrawParameters)) { return; }
    ASimpleDrawParameters = dynamic_cast<TdxChartSimpleSeriesPointDrawParameters*>(AArgs->DrawParameters);
    ASimpleDrawParameters->FillOptions->BeginUpdate();
    ASimpleDrawParameters->FillOptions->Color = TdxAlphaColors::LightCyan;
    ASimpleDrawParameters->FillOptions->Color2 = TdxAlphaColors::LightBlue;
    ASimpleDrawParameters->FillOptions->Mode = TdxFillOptionsMode::Hatch;
    ASimpleDrawParameters->FillOptions->HatchStyle = TdxFillOptionsHatchStyle::ForwardDiagonal;
    ASimpleDrawParameters->FillOptions->EndUpdate();
  }
}

Indirect TdxChartSimpleSeriesPointDrawParameters Class Reference

The TdxChartGetSeriesPointDrawParametersEventArgs.DrawParameters property references the TdxChartSimpleSeriesPointDrawParameters class as a TdxChartSeriesPointDrawParameters object when a diagram’s OnGetSeriesPointDrawParameters event occurs for a simple series.

You need to cast a TdxChartSeriesPointDrawParameters object to the TdxChartSimpleSeriesPointDrawParameters class to access all draw settings of a series point in a simple series.

Tip

You can call a TdxChartSeriesPointDrawParameters object’s ClassType function within an OnGetSeriesPointDrawParameters event handler to identify the actual point draw settings type.

Inheritance

TObject TdxChartSeriesPointDrawParameters TdxChartSimpleSeriesPointDrawParameters