AxisBase.Label Property

Provides access to the settings that specify the position and text format of axis labels.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v19.1.dll

Declaration

C#

public AxisLabel Label { get; set; }

VB.NET

Public Property Label As AxisLabel

Property Value

Type	Description
AxisLabel	An AxisLabel object which provides the axis label settings.

Remarks

Use the Label property to get access to the settings that specify the position and text format of axis labels.

Example

The following example demonstrates how to change the appearance of axis labels, for example, to rotate them by a specific angle. To accomplish this, it is necessary to create a DataTemplate that specifies the appearance of axis labels, and add it to a window’s resources collection. Then, this template can be applied to an axis label via its ChartTextElement.ElementTemplate property.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-provide-a-custom-template-for-axis-labels-e1752.

Window1.xaml

<Window x:Class="RotatedAxisXLabels.Window1" 
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
        xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts" 
        Title="Rotated AxisX Labels" Height="300" Width="400">

    <Window.Resources>
        <DataTemplate x:Key="AxisXLabelTemplate">
            <ContentPresenter Content="{Binding Path=Content}">
                <ContentPresenter.LayoutTransform>
                    <RotateTransform Angle="-90" />
                </ContentPresenter.LayoutTransform>
            </ContentPresenter>
        </DataTemplate>
    </Window.Resources>

    <Grid>
        <dxc:ChartControl Name="chartControl1">
            <dxc:ChartControl.Diagram>
                <dxc:XYDiagram2D>
                    <dxc:XYDiagram2D.AxisX>
                        <dxc:AxisX2D>
                            <dxc:AxisX2D.Label>
                                <dxc:AxisLabel ElementTemplate="{StaticResource AxisXLabelTemplate}" 
                                               Padding="0,0,5,4" />
                            </dxc:AxisX2D.Label>
                        </dxc:AxisX2D>
                    </dxc:XYDiagram2D.AxisX>
                    <dxc:XYDiagram2D.Series>
                        <dxc:BarSideBySideSeries2D>
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="First Argument" Value="1" />
                                <dxc:SeriesPoint Argument="Second Argument" Value="2" />
                                <dxc:SeriesPoint Argument="Third Argument" Value="3" />
                                <dxc:SeriesPoint Argument="Fourth Argument" Value="4" />
                                <dxc:SeriesPoint Argument="Fifth Argument" Value="5" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                    </dxc:XYDiagram2D.Series>
                </dxc:XYDiagram2D>
            </dxc:ChartControl.Diagram>
        </dxc:ChartControl>
    </Grid>
</Window>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Label property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-determine-which-chart-element-is-hovered-by-the-mouse-pointer-e4511/VB/DetermineHoveredChartElement/MainWindow.xaml#L38

</dxc:AxisY2D.Title>
<dxc:AxisY2D.Label>
    <dxc:AxisLabel Name="AxisYLabel" />

how-to-create-and-customize-custom-axis-labels-t188164/VB/CustomAxisLabel/MainWindow.xaml#L15

<dxc:AxisX2D>
    <dxc:AxisX2D.Label>
        <dxc:AxisLabel FontSize="14" Foreground="#FF0E5ED6" FontWeight="Bold"/>

how-to-bind-a-range-control-to-a-chart-control-t397808/CS/GoldPrices/MainWindow.xaml#L53

</dxc:AxisX2D.WholeRange>
<dxc:AxisX2D.Label>
    <dxc:AxisLabel TextPattern="{}{A:MMMM}"/>

how-to-provide-a-custom-template-for-axis-labels-e1752/VB/Window1.xaml#L23

<dxc:AxisX2D>
    <dxc:AxisX2D.Label>
        <dxc:AxisLabel ElementTemplate="{StaticResource AxisXLabelTemplate}"

how-to-create-a-2d-step-area-chart-e3511/VB/AreaStep2DChart/MainWindow.xaml#L24

<dxc:AxisX2D>
    <dxc:AxisX2D.Label>
        <dxc:AxisLabel Staggered="True" />