Skip to main content
All docs
V25.1
  • DxTreeListColumn.CaptionAlignment Property

    Specifies the alignment of the column’s Caption.

    Namespace: DevExpress.Blazor

    Assembly: DevExpress.Blazor.v25.1.dll

    NuGet Package: DevExpress.Blazor

    Declaration

    [DefaultValue(null)]
    [Parameter]
    public TreeListTextAlignment? CaptionAlignment { get; set; }

    Property Value

    Type Default Description
    Nullable<TreeListTextAlignment> null

    An enumeration value.

    Available values:

    Name Description
    Auto

    Aligns text based on cell content and column data type.

    Left

    Aligns cell text to the left.

    Center

    Centers cell text.

    Right

    Aligns cell text to the right.

    Remarks

    The TreeList component automatically aligns cell values depending on data types. For example, numeric values are aligned to the right in their cells. Note that the TreeList component does not change caption alignment in the same manner. You can use the DxTreeList.ColumnCaptionAlignment property to align caption text. You can specify the CaptionAlignment property to override this setting on a column level. Note that these properties do not affect command and selection columns.

    The following code snippet aligns captions of Mass, Radius, Volume, and Gravity columns to the right:

    @inject SpaceObjectDataProvider SpaceObjectDataProvider
    
    <DxTreeList Data="TreeListData" ChildrenFieldName="Satellites">
        <Columns>
            <DxTreeListDataColumn FieldName="Name" />
            <DxTreeListDataColumn FieldName="TypeOfObject" Caption="Type" />
            <DxTreeListDataColumn FieldName="Mass10pow21kg" DisplayFormat="N2"
                                  CaptionAlignment="TreeListTextAlignment.Right">
                <HeaderCaptionTemplate>Mass, 10<sup>21</sup> &#215; kg</HeaderCaptionTemplate>
            </DxTreeListDataColumn>
            <DxTreeListDataColumn FieldName="MeanRadiusInKM" Caption="Radius, km" DisplayFormat="N2"
                                  CaptionAlignment="TreeListTextAlignment.Right" />
            <DxTreeListDataColumn FieldName="Volume10pow9KM3" DisplayFormat="N2"
                                  CaptionAlignment="TreeListTextAlignment.Right">
                <HeaderCaptionTemplate>Volume, 10<sup>9</sup> &#215; km<sup>3</sup></HeaderCaptionTemplate>
            </DxTreeListDataColumn>
            <DxTreeListDataColumn FieldName="SurfaceGravity" DisplayFormat="N2"
                                  CaptionAlignment="TreeListTextAlignment.Right">
                <HeaderCaptionTemplate>Gravity, m/s<sup>2</sup></HeaderCaptionTemplate>
            </DxTreeListDataColumn>
        </Columns>
    </DxTreeList>
    
    @code {
        object TreeListData { get; set; }
    
        protected override async Task OnInitializedAsync() {
            TreeListData = SpaceObjectDataProvider.GenerateData();
        }
    }
    

    Header Caption Alignment

    To align text in data cells, use the TextAlignment property.

    Implements

    See Also