TdxGaugeScaleCollection.Items Property

Provides zero-based indexed access to scales stored by the collection.

Declaration

property Items[Index: Integer]: TdxGaugeCustomScale read; write; default;

Property Value

Type
TdxGaugeCustomScale

Remarks

The Index parameter specifies the index of a particular scale created within the Gauge Control. In order to access a particular scale, it should actually exist within the collection. You can create a scale either by using the collection’s Add method or by invoking the Gauge Control’s AddScale or AddContainer methods.

In order to access the scale-specific settings, you need to cast the returned TdxGaugeCustomScale object to the actual scale type you are currently working with. Refer to the following code example.

Delphi

var
  ACircularScale TdxGaugeCircularScale;  // Use this variable to address the circular scale-specific properties
  ALinearScale: TdxGaugeLinearScale;  // Use this variable to access the linear scale-specific properties
AMaxIndex: Integer;
//...
  AMaxIndex := 0;
  dxGaugeControl1.Scales.Add(TdxGaugeCircularScale);  // Add a circular scale
  dxGaugeControl1.Scales.Add(TdxGaugeLinearScale);  // Add a linear scale
  if(dxGaugeControl1.Scales.Count > 0) then
    AMaxIndex := dxGaugeControl.Scales.Count - 1;
// Make sure that the collection item stores the required scale type...
  if(dxGaugeControl1.Scales[AMaxIndex - 1].ClassName = 'TdxGaugeCircularScale') then
// Accessing the circular scale within the collection...
    ACircularScale := TdxGaugeCircularScale(dxGaugeControl1.Scales[AMaxIndex - 1]);
// Make sure that the collection item stores the required scale type...
  if(dxGaugeControl1.Scales[AMaxIndex].ClassName = 'TdxGaugeLinearScale') then
// Accessing the linar scale within the collection...
    ALinearScale := TdxGaugeLinearScale(dxGaugeControl1.Scales[AMaxIndex]);

C++

TdxGaugeCircularScale* ACircularScale;  // Use this pointer to address the circular scale-specific properties
  TdxGaugeLinearScale* ALinearScale;  // Use this pointer to address the linear scale-specific properties
  int AMaxIndex = 0;
//...
  dxGaugeControl1->Scales->Add(TdxGaugeCircularScale);  // Add a circular scale
  dxGaugeControl1->Scales->Add(TdxGaugeLinearScale);  // Add a linear scale
  if(dxGaugeControl1->Scales->Count > 0) {
    AMaxIndex = dxGaugeControl->Scales->Count - 1; }
// Make sure that the collection item stores the required scale type...
  if(dxGaugeControl1->Scales->Items[AMaxIndex - 1]->ClassName == "TdxGaugeCircularScale") {
// Accessing the circular scale within the collection...
    ACircularScale = static_cast<TdxGaugeCircularScale*>(dxGaugeControl1->Scales->Items[AMaxIndex - 1]);
// Make sure that the collection item stores the required scale type...
  if(dxGaugeControl1->Sclaes->Items[AMaxIndex]->ClassName == "TdxGaugeLinearScale") {
// Accessing the linear scale within the collection...
    ALinearScale = static_cast<TdxGaugeLinearScale*>(dxGaugeControl1->Scales->Items[AMaxIndex]); }

Note

In order to access a particular scale, it should actually exist within the collection. To add a scale of the required type to the collection, use the Add function.