Version

We recommend that you use the xamDataGrid control instead of the xamGrid control. The xamGrid is being planned for retirement over the next few years and will not receive any new features. We will continue to provide support and critical bug fixes for the xamGrid during this time. For help or questions on migrating your codebase to the xamDataGrid, please contact support.

Columns

The xamGrid™ control displays columns based on the property’s data type in the underlying data source. For example, if the data source contains two properties of type Boolean and String, the corresponding columns will be a checkbox column and text column. The following table displays the available column types.

Column Data Type Description

Boolean

The check state marks the Boolean value of the data.

IEnumerable

Represents a band of data.

ComboBox

Generates a ComboxBox as the content for a cell.

DateTime

Displays dates using the Microsoft WPF DatePicker control. You can determine the format of the DateColumn by setting the SelectedDateFormat property to Long or Short.

DateTime

Displays dates using the xamDateTimeInput control. You can determine the format of the DateTimeColumn by setting the SelectedDateMask property.

Other

GroupColumns allows you to group multiple columns together under a single common header.

Uri

Creates HyperlinkButton objects for the content of a cell.

URL

Displays images from the URL provided. Your end users can not edit or filter the image column.

MultiColumnComboEditor

The MultiColumnCombo column is column type that displays multiple columns in a drop down list.

Sparkline

The Sparkline column is column type that displays a sparkline chart in a cell.

Custom

The ItemTemplate feature is used in this column to set up custom content.

Other

This column type is used for all other data types.

Other

Unbound columns allow you to add columns that are not bound to any specific data.

Auto Generate Columns

The appropriate type of column is automatically generated for each publicly exposed property in the data source if xamGrid’s AutoGenerateColumns property is set to True. If you define columns for xamGrid, it will use these columns if the column’s Key property matches the name of a public property in the data source; otherwise, it will auto-generate the columns that do not match. You can turn this feature off and define your own columns if you want total control of what xamGrid displays. For more information on this, see Define Column Layout.

Custom Column Type Mapping

When the default creation of a column for a particular data type does not fit your application’s needs, you can change the column mapping to create a different column type. You can do this by using the ColumnTypeMapping object to assign a column type to use with a data type. For more information on this, see Change Column Type Mapping.