Skip to main content
All docs
V25.1
  • TdxChartPieValueLabelPosition Enum

    Enumerates value label arrangement options available in Pie and Doughnut Views.

    Declaration

    TdxChartPieValueLabelPosition = (
        Inside,
        Outside,
        TwoColumns,
        Radial,
        Tangent
    );

    Members

    Name Description
    Inside

    Default. Value labels are displayed as horizontal inscriptions within Pie or Doughnut series value slices.

    Inside, Radial, and Tangent modes arrange value labels within series value slices. Use Outside or TwoColumns when value labels do not fit into series value slices.

    Outside

    Value labels are displayed as horizontal inscriptions around a Pie or Doughnut series.

    External value labels occupy a portion of the simple diagram area allocated to the series and reduce its absolute radius. You can use the series View’s ValueLabels.LineLength property to adjust the distance between value labels and the series. If the series View’s ValueLabels.LineVisible property is set to bDefault or bTrue, lines connect external value labels to the corresponding series value slices.

    You can use the ValueLabels.ResolveOverlappingMode property to disable or enable overlapping resolution for external value labels.

    Outside and TwoColumns modes are useful when value labels do not fit into series slices.

    TwoColumns

    Value labels are arranged into two columns to the left and right of a Pie or Doughnut series.

    You can use the ValueLabels.ResolveOverlappingMode property to disable or enable overlap resolution for external value labels in this mode.

    Outside and TwoColumns modes are useful when value labels do not fit into series slices.

    Radial

    Value labels are centered within series value slices along radiuses of a Pie or Doughnut series.

    Use this mode to fit relatively long value labels within narrow series value slices.

    Tangent

    Value labels are tangent to a circle that divides a Pie or Doughnut series radius in two.

    This mode is recommended for wide value slices in a Doughnut series. If value labels are too long to fit into the corresponding slices, use Outside or TwoColumns mode instead.

    Remarks

    Value label positioning modes allow you to arrange value labels inside or outside corresponding series slices. The currently supported label overlap resolution algorithm affects only external value labels.

    Note

    TdxChartPieValueLabelPosition is a scoped enumeration type. Use the type name together with a scope resolution token (. in Delphi or :: in C++Builder) followed by an enumeration value to refer to this value. For example, use TdxChartPieValueLabelPosition.Radial (in Delphi) or TdxChartPieValueLabelPosition::Radial (in C++Builder) to refer to the Radial value in code.

    Direct TdxChartPieValueLabelPosition Type References

    The ValueLabels.Position property of Pie and Doughnut Views references the TdxChartPieValueLabelPosition type.

    See Also