GridControl.CustomizeCellDisplayText Event

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

Namespace: DevExpress.Mobile.DataGrid

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

Declaration

public event CustomizeCellDisplayTextEventHandler CustomizeCellDisplayText
Public Event CustomizeCellDisplayText As CustomizeCellDisplayTextEventHandler

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