Binding Cell Settings to Data Item Properties (xamDataGrid)

Topic Overview

Purpose

This topic describes how to bind cell settings to data item properties using the CellBindings collection property in the xamDataPresenter™ controls.

Required background

The following topics are prerequisites to understanding this topic:

Topic	Purpose
Terms and Concepts	This section defines the major elements that constitute the controls that make up The Data Presenter Family.
Adding xamDataGrid to Your Page	This topic describes how to add a xamDataGrid control to your page.
Binding xamDataGrid to Data	This section lists the topics written specifically to help you access data using xamDataGrid control.

In this topic

This topic contains the following sections:

Binding Cell Settings to Data Item Properties
Related Topics

Binding Cell Settings to Data Item Properties

Overview

Use the CellBindings collection property to facilitate the binding of a cell settings to properties exposed off the associated data item.

Create a CellBinding instance for every field’s cell property which you would like to bind to a data item property and add it to the CellBindings collection.

Note	Note Since the context of the CellBinding is the cell’s DataRecord, use the following syntax to specify the path to a data item property named "MyProperty": “ DataItem.MyProperty ”.

Property settings

The following table maps the desired configuration to the property settings that manage it.

In order to:	Use this property:	And set it to:
Configure a collection of field’s cells bindings to MVVM properties	CellBindings	CellBindingCollection
Specify that the `CellBinding` targets the ValueEditor instance within the cell’s CellValuePresenter	Target	`Editor`
Specify that the `CellBinding` targets the cell’s CellValuePresenter	Target	`CellValuePresenter`
Specify the name of a target’s property to bind	Property	`string` This property should be non-read-only `DependencyProperty`.
Specify the actual binding markup	Binding	`BindingBase`

Example

The screenshot below demonstrates how a field’s cells would look as a result of the following CellBinding settings:

Property	Value
Target	CellValuePresenter
Property	Foreground
Binding	{Binding Path=DataItem.Color}

Binding Cell Settings to MVVM properties 1.png

Following is the code that implements this example.

In C#:

public class Car : INotifyPropertyChanged
{
    private string _make;
    public string Make
    {
        get { return _make; }
        set
        {
            if (_make != value)
            {
                _make = value;
                NotifyPropertyChanged("Make");
            }
        }
    }
    private Brush _color;
    public Brush Color
    {
        get { return _color; }
        set
        {
            if (_color != value)
            {
                _color = value;
                NotifyPropertyChanged("Color");
            }
        }
    }
    #region INotifyPropertyChanged Members
    public event PropertyChangedEventHandler PropertyChanged;
    private void NotifyPropertyChanged(String info)
    {
        if (PropertyChanged != null)
        {
            PropertyChanged(this, new PropertyChangedEventArgs(info));
        }
    }
    #endregion
}

In XAML:

<igDP:XamDataGrid x:Name="XamDataGrid1"
                  DataSource="{Binding Path=Cars}">
    <igDP:XamDataGrid.FieldLayoutSettings>
        <igDP:FieldLayoutSettings AutoGenerateFields="False" />
    </igDP:XamDataGrid.FieldLayoutSettings>
    <igDP:XamDataGrid.FieldLayouts>
        <igDP:FieldLayout>
            <igDP:FieldLayout.Fields>
                <igDP:TextField Name="Make">
                    <igDP:TextField.CellBindings>
                        <igDP:CellBinding Property="Foreground"
                                          Target="CellValuePresenter"
                                          Binding="{Binding Path=DataItem.Color}" />
                    </igDP:TextField.CellBindings>
                </igDP:TextField>
            </igDP:FieldLayout.Fields>
        </igDP:FieldLayout>
    </igDP:XamDataGrid.FieldLayouts>
</igDP:XamDataGrid>

Related Topics

The following topics provide additional information related to this topic.

Topic	Purpose
Bind a DataPresenter Control to an XmlDataProvider	This topic describes how to data bind the xamDataPresenter controls to an XmlDataProvider to expose your XML file to the presentation layer of your application.
Bind a DataPresenter Control to a Collection	This topic describes how to data bind the xamDataPresenter controls to an ObjectDataProvider to expose your collection to the presentation layer of your application.
Binding a DataPresenter Control to a DataSet	This topic describes how to data bind the xamDataPresenter controls to a DataSet.
Binding Field, FieldSettings, FieldLayout and FieldLayoutSettings to MVVM properties	This topic describes how to bind the Field, FieldSettings, FieldLayout and FieldLayoutSettings to MVVM properties using the FieldBinding markup extension in the xamDataPresenter controls.
About Data Items and Data Records	This topic describes how to find the DataRecord object that corresponds to your data item.
Add Items Manually to a DataPresenter Control	This topic describes how to add your data items directly to the xamDataPresenter control’s DataItems collection.
Displaying Hierarchical Data	This topic describes how the xamDataPresenter controls display hierarchical data.
Displaying an Image in a Field	This topic describes how to display an image in a Field overriding the CellValuePresenter’s template.
Iterate through the Records Collection	This topic describes how you can iterate through the nested structure of records as well as what kind of record types you may encounter.

WPF | Help Topics