Class ChartCategory

Provides options to customize the category for the multilevel labels.

Inheritance

System.Object

ChartSubComponent

ChartCategory

Inherited Members

ChartSubComponent.BuildRenderTree(RenderTreeBuilder)

ChartSubComponent.ChildContent

ChartSubComponent.Dispose(Boolean)

Namespace: Syncfusion.Blazor.Charts

Assembly: Syncfusion.Blazor.dll

Syntax

public class ChartCategory : ChartSubComponent, ISubcomponentTracker

Remarks

This component allows you to adjust properties related to individual categories, enhancing the organizational clarity of chart labels.

Constructors

ChartCategory()

Declaration

public ChartCategory()

Properties

CustomAttributes

Gets or sets the custom attributes for multi-level labels.

Declaration

public object CustomAttributes { get; set; }

Property Value

Type	Description
System.Object	An object that represents custom attributes for multi-labels.

Remarks

The provided custom attribute can be accessed by the user from the OnAxisMultiLevelLabelRender event arguments for further actions or modifications.

Examples

This example demonstrates how to modify the text style of a multi-level label using custom attributes from the 'OnAxisMultiLevelLabelRender' event.

 

<SfChart> 
    <ChartEvents OnAxisMultiLevelLabelRender="OnMultiLevelLabelRender"></ChartEvents> 
    <ChartMultiLevelLabels> 
        <ChartMultiLevelLabel> 
            <ChartCategories> 
                <ChartCategory Start="-0.5" End="3.5" Text="Half yearly 1" MaximumTextWidth=50 CustomAttributes="@customAtt"></ChartCategory> 
                <ChartCategory Start="3.5" End="7.5" Text="Half yearly 2" MaximumTextWidth=50></ChartCategory> 
            </ChartCategories> 
        </ChartMultiLevelLabel> 
    </ChartMultiLevelLabels> 
    ... 
</SfChart> 
@code { 
    object customAtt = new ChartAxisMultiLevelLabelTextStyle 
    { 
        FontFamily = "Roboto", 
        FontWeight = "600", 
        Color = "Red", 
        Size = "14px" 
    }; 
    public void OnMultiLevelLabelRender(AxisMultiLabelRenderEventArgs args) 
    { 
        if (args.CustomAttributes != null) 
        { 
            args.TextStyle = (ChartAxisMultiLevelLabelTextStyle)args.CustomAttributes; 
        } 
    } 
}

End

Gets or sets the end value of the multi-level label.

Declaration

public object End { get; set; }

Property Value

Type	Description
System.Object	The end value of the multi-level label, specifying where the label range terminates.

Remarks

This property sets the end of a single multi-level label. It accepts the value based on the provided ValueType and axis labels.

MaximumTextWidth

Gets or sets the maximum width of the text for multi-level labels.

Declaration

public double MaximumTextWidth { get; set; }

Property Value

Type	Description
System.Double	The maximum width of the text for multi-level labels. The default value is 0.

Remarks

If the text exceeds this value, the overflow is handled based on the multi-level label's "TextOverflow" setting.

Start

Gets or sets the start value of the multi-level labels.

Declaration

public object Start { get; set; }

Property Value

Type	Description
System.Object	The start value of the multi-level label, determining where the label range begins.

Remarks

This property sets the start of a single multi-level label. It accepts the value based on the provided ValueType and axis labels.

Text

Gets or sets the text for the multi-level labels.

Declaration

public string Text { get; set; }

Property Value

Type	Description
System.String	A string representing the text for the multi-level labels. The default value is an empty string.

Remarks

This property specifies the label text that will be displayed for a multi-level category in the chart. You can set this to any descriptive text necessary to identify the category.

Type

Gets or sets the border type for the individual multi-level label.

Declaration

public BorderType Type { get; set; }

Property Value

Type	Description
BorderType	One of the BorderType enumerations that specifies the border type for the individual multi-level label. The options include: `Rectangle` `WithoutTopBorder` `WithoutTopandBottomBorder` `WithoutBorder` `Brace` `CurlyBrace` The default value is BorderType.Auto.

Remarks

The multi-level label for this category will be rendered with the specified border type.

Methods

OnInitialized()

Declaration

protected override void OnInitialized()

OnParametersSet()

Declaration

protected override void OnParametersSet()

Overrides

ChartSubComponent.OnParametersSet()