ChartAxis

ChartAxis class

Represents the axis options of the chart.

To learn more, visit the Working with Charts documentation article.

public class ChartAxis

Properties

NameDescription
AxisBetweenCategories { get; set; }Gets or sets a flag indicating whether the value axis crosses the category axis between categories.
BaseTimeUnit { get; set; }Returns or sets the smallest time unit that is represented on the time category axis.
CategoryType { get; set; }Gets or sets type of the category axis.
Crosses { get; set; }Specifies how this axis crosses the perpendicular axis.
CrossesAt { get; set; }Specifies where on the perpendicular axis the axis crosses.
DisplayUnit { get; }Specifies the scaling value of the display units for the value axis.
Document { get; }Returns the document containing the parent chart.
Format { get; }Provides access to line formatting of the axis and fill of the tick labels.
HasMajorGridlines { get; set; }Gets or sets a flag indicating whether the axis has major gridlines.
HasMinorGridlines { get; set; }Gets or sets a flag indicating whether the axis has minor gridlines.
Hidden { get; set; }Gets or sets a flag indicating whether this axis is hidden or not.
MajorTickMark { get; set; }Returns or sets the major tick marks.
MajorUnit { get; set; }Returns or sets the distance between major tick marks.
MajorUnitIsAuto { get; set; }Gets or sets a flag indicating whether default distance between major tick marks shall be used.
MajorUnitScale { get; set; }Returns or sets the scale value for major tick marks on the time category axis.
MinorTickMark { get; set; }Returns or sets the minor tick marks for the axis.
MinorUnit { get; set; }Returns or sets the distance between minor tick marks.
MinorUnitIsAuto { get; set; }Gets or sets a flag indicating whether default distance between minor tick marks shall be used.
MinorUnitScale { get; set; }Returns or sets the scale value for minor tick marks on the time category axis.
NumberFormat { get; }Returns a ChartNumberFormat object that allows defining number formats for the axis.
ReverseOrder { get; set; }Returns or sets a flag indicating whether values of axis should be displayed in reverse order, i.e. from max to min.
Scaling { get; }Provides access to the scaling options of the axis.
TickLabels { get; }Provides access to the properties of the axis tick mark labels.
TickMarkSpacing { get; set; }Gets or sets the interval, at which tick marks are drawn.
Title { get; }Provides access to the axis title properties.
Type { get; }Returns type of the axis.

Examples

Shows how to insert a chart and modify the appearance of its axes.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Column, 500, 300);
Chart chart = shape.Chart;

// Clear the chart's demo data series to start with a clean chart.
chart.Series.Clear();

// Insert a chart series with categories for the X-axis and respective numeric values for the Y-axis.
chart.Series.Add("Aspose Test Series",
    new[] { "Word", "PDF", "Excel", "GoogleDocs", "Note" },
    new double[] { 640, 320, 280, 120, 150 });

// Chart axes have various options that can change their appearance,
// such as their direction, major/minor unit ticks, and tick marks.
ChartAxis xAxis = chart.AxisX;
xAxis.CategoryType = AxisCategoryType.Category;
xAxis.Crosses = AxisCrosses.Minimum;
xAxis.ReverseOrder = false;
xAxis.MajorTickMark = AxisTickMark.Inside;
xAxis.MinorTickMark = AxisTickMark.Cross;
xAxis.MajorUnit = 10.0d;
xAxis.MinorUnit = 15.0d;
xAxis.TickLabels.Offset = 50;
xAxis.TickLabels.Position = AxisTickLabelPosition.Low;
xAxis.TickLabels.IsAutoSpacing = false;
xAxis.TickMarkSpacing = 1;

ChartAxis yAxis = chart.AxisY;
yAxis.CategoryType = AxisCategoryType.Automatic;
yAxis.Crosses = AxisCrosses.Maximum;
yAxis.ReverseOrder = true;
yAxis.MajorTickMark = AxisTickMark.Inside;
yAxis.MinorTickMark = AxisTickMark.Cross;
yAxis.MajorUnit = 100.0d;
yAxis.MinorUnit = 20.0d;
yAxis.TickLabels.Position = AxisTickLabelPosition.NextToAxis;
yAxis.TickLabels.Alignment = ParagraphAlignment.Center;
yAxis.TickLabels.Font.Color = Color.Red;
yAxis.TickLabels.Spacing = 1;

// Column charts do not have a Z-axis.
Assert.Null(chart.AxisZ);

doc.Save(ArtifactsDir + "Charts.AxisProperties.docx");

See Also