GridDimensionColumn Class

A dimension column in a GridDashboardItem.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v21.2.Core.dll

Declaration

C#

public class GridDimensionColumn :
    GridColumnBase,
    IDimensionable

VB.NET

Public Class GridDimensionColumn
    Inherits GridColumnBase
    Implements IDimensionable

Remarks

Displays grouped values from the bound data item and allows you to provide discrete categorical information.

A dimension column accepts values of any type:

Type	Example	Description
string		Displays string values.
numeric		Displays numeric (integer or float) values.
date		Displays date-time values. For these values, you can change a group interval. Right-click the data item and select the required group interval.
boolean		Displays boolean values as true or false.
object		The dimension column can display images if it is bound to a data source containing images. You can choose whether the dimension column shows data as images or text (strings that encode images in the base64 format). To do this, click the data item’s Options button and specify how to show values.

Use the GridDimensionColumn.Dimension property to specify the dimensions to which the column is bound.

If the bound dimension contains image data, the dimension column can display images. Set the GridDimensionColumn.DisplayMode property to GridDimensionColumnDisplayMode.Image to specify that images should be displayed within this column.

The following code snippet creates the Dimension column:

C#

var grid = new GridDashboardItem();
grid.DataSource = dataSource;

var gridDimension = new GridDimensionColumn();
gridDimension.Dimension = new Dimension("Category");

grid.Columns.Add(gridDimension);

VB.NET

Dim grid As New GridDashboardItem()
grid.DataSource = dataSource

Dim gridDimension As New GridDimensionColumn()
gridDimension.Dimension = New Dimension("Category")

grid.Columns.Add(gridDimension)

Related GitHub Examples

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

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#

win-dashboard-designer-master-drill-down/CS/WinForms_Dashboard_Drill-Down/Form1.cs#L25

GridDashboardItem grid = new GridDashboardItem() { DataSource = ds };
grid.Columns.Add(new GridDimensionColumn(new Dimension("Dimension1")));
grid.Columns.Add(new GridDimensionColumn(new Dimension("Dimension2")));

wpf-dashboard-viewer-item-tabs/CS/WpfDashboardTabSupportExample/WpfDashboardTabSupportExample/MainWindow.xaml.cs#L49

gridItem.DataSource = dataSource;
gridItem.Columns.Add(new GridDimensionColumn(new Dimension("Country")));
gridItem.Columns.Add(new GridMeasureColumn(new Measure("Sales")));

winforms-dashboard-viewer-item-tabs/CS/TabSupportExample/DashboardItemGenerator.cs#L57

gridItem.Columns.Add(new GridDimensionColumn(new Dimension("Country")));
gridItem.Columns.Add(new GridMeasureColumn(new Measure("Sales")));

how-to-apply-conditional-formatting-to-grid-cells-in-win-dashboard/CS/Dashboard_ConditionalFormatting_Grid/TopAverageConditionForm.cs#L12

GridDashboardItem grid = (GridDashboardItem)dashboard.Items["gridDashboardItem1"];
GridDimensionColumn salesPerson = (GridDimensionColumn)grid.Columns[0];
GridMeasureColumn extendedPrice = (GridMeasureColumn)grid.Columns[1];

how-to-apply-conditional-formatting-to-grid-cells-using-the-date-occurring-format-condition-t267749/CS/Grid_DateOccurring/Form1.cs#L15

GridDashboardItem grid = (GridDashboardItem)dashboard.Items["gridDashboardItem1"];
GridDimensionColumn date = (GridDimensionColumn)grid.Columns[0];

VB.NET

win-dashboard-designer-master-drill-down/VB/WinForms_Dashboard_Drill-Down/Form1.vb#L27

Dim grid As New GridDashboardItem() With {.DataSource = ds}
grid.Columns.Add(New GridDimensionColumn(New Dimension("Dimension1")))
grid.Columns.Add(New GridDimensionColumn(New Dimension("Dimension2")))

wpf-dashboard-viewer-item-tabs/VB/WpfDashboardTabSupportExample/WpfDashboardTabSupportExample/MainWindow.xaml.vb#L33

gridItem.DataSource = dataSource
gridItem.Columns.Add(New GridDimensionColumn(New Dimension("Country")))
gridItem.Columns.Add(New GridMeasureColumn(New Measure("Sales")))

winforms-dashboard-viewer-item-tabs/VB/TabSupportExample/DashboardItemGenerator.vb#L56

gridItem.Columns.Add(New GridDimensionColumn(New Dimension("Country")))
gridItem.Columns.Add(New GridMeasureColumn(New Measure("Sales")))

how-to-apply-conditional-formatting-to-grid-cells-in-win-dashboard/VB/Dashboard_ConditionalFormatting_Grid/TopAverageConditionForm.vb#L15

Dim grid As GridDashboardItem = CType(dashboard.Items("gridDashboardItem1"), GridDashboardItem)
Dim salesPerson As GridDimensionColumn = CType(grid.Columns(0), GridDimensionColumn)
Dim extendedPrice As GridMeasureColumn = CType(grid.Columns(1), GridMeasureColumn)

how-to-apply-conditional-formatting-to-grid-cells-using-the-date-occurring-format-condition-t267749/VB/Grid_DateOccurring/Form1.vb#L17

Dim grid As GridDashboardItem = CType(dashboard.Items("gridDashboardItem1"), GridDashboardItem)
Dim [date] As GridDimensionColumn = CType(grid.Columns(0), GridDimensionColumn)

Implements

ICustomPropertyProvider

Inheritance

Object

DataItemContainer

NamedDataItemContainer

GridColumnBase

GridDimensionColumn