IChartAxis.TextIsStagger

Syntax

TextIsStagger: Boolean;

Description

The TextIsStagger property determines whether the labels of chart category axis can be arranged in a staggered pattern.

Comments

The property is relevant only for the category axis, and any attempt to set this property for other types of axes throws an exception.

The labels can be arranged in a staggered pattern only if:

Rotation angle of labels is equal to zero for the left-to-right chart orientation.
Rotation angle of labels is equal to 90 degrees for the top-to-bottom chart orientation.

The property is saved together with the chart.

Example

Executing the example requires a regular report with the Rep_1 identifier with a chart on the report sheet. The inspector of unit assemblies must contain links to the Chart, Report, Tab and Metabase system assemblies.

Sub macro;
Var
    mb: IMetabase;
    report: IPrxReport;
    chart: IChart;
    aX: IChartAxis;
Begin
    mb := MetabaseClass.Active;
    report := mb.ItemById("Rep_1").Edit As IPrxReport;
    chart := (report.ActiveSheet As IPrxTable).TabSheet.Objects.Item(0).Extension As IChart;
    aX := chart.AxisX;
    aX.TextHorizontalAlignment := ChartHorizontalAlignment.Left;
    aX.TextIsStagger := True;
    aX.TextStaggerOddFirst := True;
    (report As IMetabaseObject).Save;
End Sub macro;

After executing the example the category axis labels are arranged in a staggered pattern and aligned to the left with odd labels in the first row.