VGridControlBase.RecordCellStyle Event

Enables the appearance settings of individual cells to be changed.

Namespace: DevExpress.XtraVerticalGrid

Assembly: DevExpress.XtraVerticalGrid.v20.1.dll

Declaration

public event GetCustomRowCellStyleEventHandler RecordCellStyle
Public Event RecordCellStyle As GetCustomRowCellStyleEventHandler

Event Data

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

Property Description
Appearance Gets the appearance settings used to paint the cell currently being processed.
CellIndex Gets the processed cell's index. Inherited from RowCellEventArgs.
RecordIndex Gets the index of the record containing the processed cell. Inherited from RowCellEventArgs.
Row Gets the processed row. Inherited from RowEventArgs.

Remarks

The RecordCellStyle event is raised for individual cells before they need to be repainted. The referenced cell can be identified using the event parameter's RowEventArgs.Row, RowCellEventArgs.RecordIndex and RowCellEventArgs.CellIndex properties. To customize the cell's appearance settings use the GetCustomRowCellStyleEventArgs.Appearance property.

Individual cells can also be custom painted. Handle the VGridControlBase.CustomDrawRowValueCell event for this purpose.

IMPORTANT

Do not change cell values, modify the control's layout, or change the control's object model in the events used for custom control painting. Actions that update the layout can cause the control to malfunction.

Examples

The following example handles the VGridControlBase.RecordCellStyle event to modify the appearance of the "Price" row's cells whose values are greater than 30,000.

GetCustomRowCellStyle event

using DevExpress.XtraVerticalGrid.Events;

private void vGridControl1_RecordCellStyle(object sender, GetCustomRowCellStyleEventArgs e) {
   if(e.Row != rowPrice) return;
   if(Convert.ToInt32(vGridControl1.GetCellValue(e.Row, e.RecordIndex)) > 30000) {
      e.Appearance.BackColor = Color.Yellow;
      e.Appearance.ForeColor = Color.Black;
      e.Appearance.Font = new Font(e.Appearance.Font.Name, 
        e.Appearance.Font.Size, FontStyle.Bold);
   }
}
See Also