Skip to main content

GridControl.CustomizeCellDisplayText Event

Enables custom display text to be provided for any data cell.

Namespace: DevExpress.Mobile.DataGrid

Assembly: DevExpress.Mobile.Grid.v18.2.dll

Declaration

public event CustomizeCellDisplayTextEventHandler CustomizeCellDisplayText

Remarks

Important

This documentation topic describes legacy technology. We no longer develop new functionality for the GridControl and suggest that you use the new DataGridView control instead.

The CustomizeCellDisplayText event can be used to display custom text within any cell. This event is fired for both bound and unbound columns. The text provided via this event will be used when the grid is printed.

The CustomizeCellDisplayText event is raised only when a unique edit value is assigned to a grid cell.

Initially the CustomizeCellDisplayTextEventArgs.DisplayText parameter contains the cell’s current display text. To provide custom display text, assign the required string to this property.

The CustomizeCellDisplayText event is called in various instances:

  • To provide a cell’s display text when data is not sorted by a column.
  • To provide column display text and compare the supplied strings when data is grouped or sorted by this column.

In most instances the CustomizeCellDisplayText event cannot be used to supply custom display text to a column based on values of other cells. A solution to this task is to create an unbound column to provide custom display text.

See Also