Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TimeColumn Class

A grid column used to display and edit the time.

Namespace: DevExpress.Maui.DataGrid

Assembly: DevExpress.Maui.DataGrid.dll

NuGet Package: DevExpress.Maui.DataGrid

#Declaration

C#
public class TimeColumn :
    TextColumnBase

#Remarks

The TimeColumn is a column in the DataGridView that displays DateTime or TimeSpan values.

.NET MAUI DataGrid - TimeColumn .NET MAUI DataGrid - TimeColumn

When a user taps a cell, the standard iOS or Android time picker appears that allows the user to select the time.

.NET MAUI DataGrid - TimeColumn.Picker .NET MAUI DataGrid - TimeColumn Picker

#Options

Use the following properties to adjust column settings:

  • TimeFormatMode — specifies whether values in cells are displayed in 12- or 24-hour format.
  • IsTimeIconVisible — specifies whether the time icon is displayed in the focused cell.

You can configure the following options related to all types of grid columns:

  • FieldName — specifies the name of the data source’s field associated with the grid column, or serves as an identifier for an unbound column.
  • Caption — specifies the caption displayed in the column header.
  • DisplayFormat — specifies the pattern used to format values in the column’s cells.
  • HorizontalContentAlignment, VerticalContentAlignment — specify the horizontal and vertical alignment of the column’s content.
  • MinWidth, MaxWidth, Width — specify the column’s minimum, maximum, and actual widths.
  • IsVisible — specifies whether the column is visible in the grid.

Use the following properties to sort and group data in the grid, and calculate cell values based on expressions:

The grid stores columns in the DataGridView.Columns collection. Depending on the AutoGenerateColumnsMode option, the grid automatically generates columns based on the bound data source, or you can add columns to the grid and associate them with data fields manually. See the following help topic for an example: Create Columns for Different Data Types.

#Example

The example below binds a TimeColumn to a TimeSpan data field.

<dxg:DataGridView ItemsSource="{Binding Path=OutlookData}">
    <dxg:DataGridView.Columns>
        <dxg:TimeColumn FieldName="Time"
                        IsTimeIconVisible="True"
                        TimeFormatMode="HourFormat12"/>
    </dxg:DataGridView.Columns>
</dxg:DataGridView>

#Inheritance

See Also