GridView.RowStyle Event

The event handler receives an argument of type RowStyleEventArgs containing data related to this event.

The RowStyle event is raised for individual data or group rows before they are repainted. The appearance settings of the data and group rows are specified by the GridViewAppearances.Row and GridViewAppearances.GroupRow properties, respectively. Handle this event to override the appearance settings of individual rows.

The processed row can be identified using the event parameter's RowEventArgs.RowHandle property. Its appearance settings are returned by the RowCellStyleEventArgs.Appearance property.

Setting an image to the Appearance.Image property has no effect when custom painting via the RowStyle and RowCellStyle events.

The appearance of selected rows cannot be customized via the RowStyle event. Use the CustomDrawCell event instead.

In the following example the RowStyle event is handled to customize the appearance of rows which have the value "Beverages" in the Category column. These rows are painted using gradient filling. The starting and ending gradient colors are specified via the AppearanceObject.BackColor and AppearanceObject.BackColor2 properties of the event's RowStyleEventArgs.Appearance parameter.

The result is displayed below. Note that the gradients are applied to the entire rows and not to individual cells:

using DevExpress.XtraGrid.Views.Grid;

private void gridView1_RowStyle(object sender, 
DevExpress.XtraGrid.Views.Grid.RowStyleEventArgs e) {
   GridView View = sender as GridView;
   if(e.RowHandle >= 0) {
      string category = View.GetRowCellDisplayText(e.RowHandle, View.Columns["Category"]);
      if(category == "Beverages") {
         e.Appearance.BackColor = Color.Salmon;
         e.Appearance.BackColor2 = Color.SeaShell;
      }            
   }
}

Imports DevExpress.XtraGrid.Views.Grid

Private Sub GridView1_RowStyle(ByVal sender As Object, _ 
ByVal e As DevExpress.XtraGrid.Views.Grid.RowStyleEventArgs) Handles GridView1.RowStyle
   Dim View As GridView = sender
   If (e.RowHandle >= 0) Then
      Dim category As String = View.GetRowCellDisplayText(e.RowHandle, View.Columns("Category"))
      If category = "Beverages" Then
         e.Appearance.BackColor = Color.Salmon
         e.Appearance.BackColor2 = Color.SeaShell
      End If
   End If
End Sub