QualitativeAxisX Class
An axis that displays qualitative arguments.
Namespace: DevExpress.XamarinForms.Charts
Assembly: DevExpress.XamarinForms.Charts.dll
NuGet Package: DevExpress.XamarinForms.Charts
Declaration
public class QualitativeAxisX :
AxisXRemarks
The ChartView chooses the X-axis type depending on data in the first series. If arguments are string values, the chart uses a QualitativeAxisX.
The ChartView.AxisX property allows you to access the automatically created axis. If you need to create and customize axes for individual series, use the Series.AxisX property.
<dxc:ChartView>
<!--Specify an X-axis at the chart level-->
<dxc:ChartView.AxisX>
<dxc:QualitativeAxisX />
</dxc:ChartView.AxisX>
<dxc:ChartView.Series>
<dxc:LineSeries>
<!--Specify an X-axis at the series level-->
<dxc:LineSeries.AxisX>
<dxc:QualitativeAxisX />
</dxc:LineSeries.AxisX>
</dxc:LineSeries>
</dxc:ChartView.Series>
</dxc:ChartView>
The QualitativeAxisX class properties allow you to configure the axis range, labels, title, constant lines, strips, gridlines, tickmarks and interlacing colors, and change the axis position.
Axis Range
The ChartView automatically calculates the axis range based on data series values. To specify a custom range for the axis, set the Range property to a QualitativeRange object and use the following settings:
- Min and Max - Specify the entire range of the axis scale. A chart does not visualize data that is out of this range. A user can scroll the chart through this range when scroll is enabled for the X-axis (ChartView.AxisXNavigationMode).
- VisualMin and VisualMax - Configure the axis scale range visible on the screen.
- SideMargin - Sets the value of margins on both sides of the axis.
<dxc:QualitativeAxisX>
<dxc:QualitativeAxisX.Range>
<dxc:QualitativeRange Min="A" Max="G"
VisualMin="B" VisualMax="F"
SideMargin="0.3"/>
</dxc:QualitativeAxisX.Range>
</dxc:QualitativeAxisX>
Axis Labels
To configure axis labels, set the Label property to an AxisLabel object and use the following settings:
- TextFormat - Specifies the text pattern applied to axis labels.
- Position - Specifies the position of axis labels.
- Style - Allows you to access an AxisLabelStyle object that stores label appearance settings (TextStyle).
- Visible - Allows you to show or hide axis labels.
<dxc:QualitativeAxisX>
<dxc:QualitativeAxisX.Label>
<dxc:AxisLabel>
<dxc:AxisLabel.Style>
<dxc:AxisLabelStyle>
<dxc:AxisLabelStyle.TextStyle>
<dxc:TextStyle Size="10"/>
</dxc:AxisLabelStyle.TextStyle>
</dxc:AxisLabelStyle>
</dxc:AxisLabel.Style>
</dxc:AxisLabel>
</dxc:QualitativeAxisX.Label>
</dxc:QualitativeAxisX>
Axis Title
Use the Title property to access an AxisTitle object that stores the following settings of an axis title:
- Text - Gets or sets the text the title displays.
- Alignment - Gets or sets the axis title alignment.
- Style - Allows you to access a TitleStyle object that stores title appearance settings (TextStyle).
- Visible - Allows you to show or hide the axis title.
<dxc:QualitativeAxisX>
<dxc:QualitativeAxisX.Title>
<dxc:AxisTitle Text="Country">
<dxc:AxisTitle.Style>
<dxc:TitleStyle>
<dxc:TitleStyle.TextStyle>
<dxc:TextStyle Size="15"/>
</dxc:TitleStyle.TextStyle>
</dxc:TitleStyle>
</dxc:AxisTitle.Style>
</dxc:AxisTitle>
</dxc:QualitativeAxisX.Title>
</dxc:QualitativeAxisX>
Constant Lines
A constant line highlights an axis value as a line perpendicular to the axis.
You can add a constant line to a qualitative X-axis. To do this, add a QualitativeConstantLine object with the specified AxisValue property to the QualitativeAxisX.ConstantLines collection. Use the following properties of the QualitativeConstantLine object to customize the constant line appearance and visibility:
- Style - Gets or sets the constant line appearance settings.
- ShowBehind - Specifies whether the constant line is displayed behind series.
- Title, LegendText - Specify settings of the constant line captions displayed on the chart and in the chart legend.
- Visible, VisibleInLegend - Specify whether the constant line is visible on the chart and in the chart legend.
<dxc:QualitativeAxisX>
<dxc:QualitativeAxisX.ConstantLines>
<dxc:QualitativeConstantLine AxisValue="Triassic">
<dxc:QualitativeConstantLine.Title>
<dxc:ConstantLineTitle Text="First Dinosaurs">
<dxc:ConstantLineTitle.Style>
<dxc:TitleStyle>
<dxc:TitleStyle.TextStyle>
<dxc:TextStyle Color="Green" Size="20"/>
</dxc:TitleStyle.TextStyle>
</dxc:TitleStyle>
</dxc:ConstantLineTitle.Style>
</dxc:ConstantLineTitle>
</dxc:QualitativeConstantLine.Title>
<dxc:QualitativeConstantLine.Style>
<dxc:ConstantLineStyle Stroke="Green" Thickness="2"/>
</dxc:QualitativeConstantLine.Style>
</dxc:QualitativeConstantLine>
</dxc:QualitativeAxisX.ConstantLines>
</dxc:QualitativeAxisX>
Strips
A strip highlights a range between two values of an axis and allows you to trace whether series point values fall in or out of that range. A strip can have its own label that is shown instead of axis labels.
To specify a strip for a qualitative X-axis, add a QualitativeStrip object to the QualitativeAxisX.Strips collection and use the following settings:
- MinLimit or MinLimitEnabled - Specify the strip’s minimum limit value.
- MaxLimit or MaxLimitEnabled - Specify the strip’s maximum limit value.
- VisibleInLegend, LegendText - Specify whether the strip is visible in the legend, and the strip caption that the legend shows.
- AxisLabel - Specifies the strip label displayed on the axis.
- Style - Gets or sets the strip appearance settings.
<dxc:QualitativeAxisX>
<dxc:QualitativeAxisX.Strips>
<dxc:QualitativeStrip MinLimit="Triassic" MaxLimit="Cretaceous"
LegendText="Mesozoic Era" VisibleInLegend="True">
<dxc:QualitativeStrip.Style>
<dxc:StripStyle Fill="LightGreen"/>
</dxc:QualitativeStrip.Style>
</dxc:QualitativeStrip>
</dxc:QualitativeAxisX.Strips>
</dxc:QualitativeAxisX>
Axis Appearance
Use the Style property to access an AxisStyle object that stores visibility and appearance settings for the following elements of an axis:
Element | Properties |
|---|---|
Axis Line | |
Major Tickmarks | MajorTickmarksVisible, MajorTickmarksThickness, MajorTickmarksLength |
Minor Tickmarks | MinorTickmarksVisible, MinorTickmarksThickness, MinorTickmarksLength |
Major Gridlines | MajorGridlinesVisible, MajorGridlinesColor, MajorGridlinesThickness |
Minor Gridlines | MinorGridLinesVisible, MinorGridlinesColor, MinorGridlinesThickness |
Interlacing |
Note
Axis labels, title, constant lines and strips have Style properties that manage the appearance of these elements.
<dxc:QualitativeAxisX>
<dxc:QualitativeAxisX.Style>
<dxc:AxisStyle LineColor="#757575" LineThickness="2"
MajorGridlinesVisible="True" MajorGridlinesColor="#909090"
MajorTickmarksVisible="True" MajorTickmarksLength="10" MajorTickmarksThickness="2"
MinorTickmarksVisible="True" MinorTickmarksLength="5"
InterlacedVisible="True" InterlacedColor="#f1f3f0"/>
</dxc:QualitativeAxisX.Style>
</dxc:QualitativeAxisX>
Axis Position
Use the DisplayPosition property to specify where an X-axis should be positioned within the chart diagram.
This example anchors an X-axis to the top side of the chart’s plot area:
<dxc:QualitativeAxisX>
<dxc:QualitativeAxisX.DisplayPosition>
<dxc:AxisDisplayPositionFar/>
</dxc:QualitativeAxisX.DisplayPosition>
</dxc:QualitativeAxisX>