GridControl.CustomColumnDisplayText Event

Allows you to customize a data cell‘s display text.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v21.1.dll

Declaration

public event CustomColumnDisplayTextEventHandler CustomColumnDisplayText

Event Data

The CustomColumnDisplayText event's data class is CustomColumnDisplayTextEventArgs. The following properties provide information specific to this event:

Property Description
Column Gets the column which owns the processed cell.
DisplayText Gets or sets the display text for the cell currently being processed.
ListSourceIndex Gets the index of a record in a data source that corresponds to the processed data row.
Row Gets the row which owns the processed cell.
RowHandle Gets the processed row’s handle.
ShowAsNullText Specifies whether text corresponding to a null value appears faded.
Source Gets the grid control that raised the event.
Value Gets the processed cell’s value.

Remarks

The CustomColumnDisplayText event occurs for both bound and unbound columns. The printed GridControl displays customized text as well.

If you want to maintain a clean MVVM pattern and customize a data cell’s display text in a View Model, create a command and bind it to the CustomColumnDisplayTextCommand property.

The CustomColumnDisplayTextEventArgs.DisplayText property contains a cell’s current display text. To customize the display text, assign a string value to this property.

<dxg:GridColumn FieldName="Value"/>
void grid_CustomColumnDisplayText(object sender, CustomColumnDisplayTextEventArgs e) {
    if (e.Column.FieldName == "Value")
        e.DisplayText = string.Format("{0:n2}", e.Value);
} 

If column data is sorted or grouped, the event’s RowHandle and ListSourceRowIndex properties return invalid values. As a result, you cannot determine the processed row and obtain other cell values. To customize display text, you can instead use techniques described in the following topic: Format Cell Values.

See Also