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.
Control the Virtualization Process
Virtualization only creates controls for cells in the view port, so you must be aware of a few things when customizing the xamGrid™ control’s cells to avoid unexpected behaviors.
First, you should avoid directly accessing the content control attached to a cell since the content control might not exist. As mentioned previously, controls are only created when in view; therefore, you should only access a cell’s attached content control when you know it is in the view port. The xamGrid control exposes the CellControlAttached event to let you know when a control has been attached to a cell.
Second, you should use styles to customize the appearance of a cell. Since UIElements are recycled, setting the appearance-related properties directly on a cell’s attached content control results in duplicates that you might not expect. For example, if you set the Background property of a cell’s attached content control and you scroll more cells into view, you may see that same color in other cells as the UIElement are reused. However, if for some reason you cannot set a style, you can set the attached content control’s property in the CellControlAttached event and set the IsDirty property to mark that the content control should not be reused.
The following code shows how to handle the CellControlAttached event and set the property of a cell’s attached content control.
Private Sub xamGrid1_CellControlAttached(ByVal sender As System.Object, ByVal e As Infragistics.Controls.Grids.CellControlAttachedEventArgs)
If e.Cell.Column.Key = "ReorderLevel" Then
Dim product As Product = TryCast(e.Cell.Row.Data, Product)
If product.ReorderLevel = 0 Then
' Setting the control's property directly
e.Cell.Control.Background = New SolidColorBrush(Colors.Red)
' Set the IsDirty property to flag that the control should not be reused
e.IsDirty = True
End If
End If
End Sub
private void xamGrid1_CellControlAttached(object sender, Infragistics.Controls.Grids.CellControlAttachedEventArgs e)
{
if (e.Cell.Column.Key == "ReorderLevel")
{
Product product = e.Cell.Row.Data as Product;
if (product.ReorderLevel == 0)
{
// Setting the control's property directly
e.Cell.Control.Background = new SolidColorBrush(Colors.Red);
// Set the IsDirty property to flag that the control should not be reused
e.IsDirty = true;
}
}
}
