WinUI | ComponentOne
Controls / FlexChart / Elements / Axes / Axis Elements
In This Topic
    Axis Elements
    In This Topic

    A chart axis constitutes of various elements such as axis title, tick marks, grid lines, axis units etc. FlexChart provides a number of properties to deal with and customize these elements, so that you can display your data in the most effective manner.

    Axis elements

    Axis Title

    Axis title is the text that appears alongside each axis and summarizes the data shown on the same. In FlexChart, you can set the axis title by accessing the Title property of Axis class. It also lets you customize the axis title using the TitleStyle property.

    C#
    Copy Code
    //Set Axis title
    this.flexChart.AxisY.Title = "Revenues";
    this.flexChart.AxisX.Title = "Date";
                
    //Set Axis title style
    this.flexChart.AxisX.TitleStyle = new ChartStyle()
    {
        FontFamily = new FontFamily("Arial"),
        FontSize = 14,
        Stroke = new SolidColorBrush() { Color = Windows.UI.Color.FromArgb(255, 0, 0, 255) }
    };
    this.flexChart.AxisY.TitleStyle = new ChartStyle()
    {
        FontFamily = new FontFamily("Arial"),
        FontSize = 14,
        Stroke = new SolidColorBrush() { Color = Windows.UI.Color.FromArgb(255, 0, 0, 255) }
    };
    

    Axis Units

    As the scale is defined by FlexChart automatically when data is supplied to it, major and minor axis units of the value axis are also calculated as a part of the process. However, you can change the values of major and minor units by setting the MajorUnit and MinorUnit property of the Axis class. In case of a DateTime axis, FlexChart provides you an option to set the time unit as well using the TimeUnit property which lets you choose from day, month, quarter, week, and year options. This property accepts values from the TimeUnits enumeration. So, for setting the major interval on a DateTime axis to 3 months, you need to set the TimeUnit property to Month and MajorUnit property to 3.

    C#
    Copy Code
    this.flexChart.AxisY.MajorUnit = 1000;
    this.flexChart.AxisY.MinorUnit = 500;
    

    Axis Tick Marks

    Tick marks are the small marks or reference points to present the intervals created by dividing the axis according to major and minor units on a value axis. In case of category axis, these marks help in identifying the position of category values on the axis. Evidently, there are no minor tick marks on a category axis. By default, FlexChart sets up X-axis with major tick marks appearing outside the plot and Y-axis with no tick marks. However, you can change the position or visibility by setting the MajorTickMarks or MinorTickMarks properties which accept the value from TickMark enumeration. The enumeration lets you set the position of tick marks to appear inside, outside or crossing on the axis. You can also set this property to None, so the tick marks do not appear at all. Moreover, length of the tick marks can also be modified using the TickLength property.

    C#
    Copy Code
    //Setting location for major & minor tick marks for AxisX
    this.flexChart.AxisX.MajorTickMarks = TickMark.Outside;
    this.flexChart.AxisX.MinorTickMarks = TickMark.None;
    

    Axis Grid Lines

    Grid lines are the lines that extend from tick marks perpendicular to the axis and facilitate the viewers with cues to know the unlabeled data points. By default, FlexChart renders the grid lines on a Y-axis but not on X-axis of the chart. However, you can choose to display or hide the same by setting the MajorGrid or MinorGrid properties of the Axis class. You can also customize the appearance of grid lines by setting the MajorGridStyle and MinorGridStyle properties.

    C#
    Copy Code
    this.flexChart.AxisY.MajorGrid = true;
    

    Axis Labels

    Axis labels are the text referring to major divisions which appear along an axis. For information about axis labels in FlexChart, see Axis Labels.