ChartAxis
Contents
[
Hide
]ChartAxis class
Represents the axis options of the chart.
To learn more, visit the Working with Charts documentation article.
public class ChartAxis
Properties
| Name | Description |
|---|---|
| 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
- namespace Aspose.Words.Drawing.Charts
- assembly Aspose.Words
