QualitativeAxisX Class
An axis that displays qualitative arguments.
Namespace: DevExpress.Maui.Charts
Assembly: DevExpress.Maui.Charts.dll
NuGet Package: DevExpress.Maui.Charts
#Declaration
public class QualitativeAxisX :
AxisX
#Remarks
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. This is a bindable property.
- Alignment - Gets or sets the alignment of the axis title relative to the axis. This is a bindable property.
- 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. This is a bindable property.
- ShowBehind - Gets or sets whether the constant line is displayed behind series. This is a bindable property.
- 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 | Major |
Minor Tickmarks | Minor |
Major Gridlines | Major |
Minor Gridlines | Minor |
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>