PivotGridXlsExportOptions.CustomizeCell Event

Allows you to customize a PivotGrid cell in the exported XLS document. Only available in data-aware export mode.

Namespace: DevExpress.Xpf.PivotGrid

Assembly: DevExpress.Xpf.PivotGrid.v21.2.dll

Declaration

public event CustomizePivotCellEventHandler CustomizeCell

Remarks

Follow the steps below to customize data in the output document.

  1. Create the PivotGridXlsExportOptions instance.
  2. Handle the PivotGridXlsExportOptions.CustomizeCell event.
  3. Use the CustomizePivotCellEventArgs.Formatting property to specify the cell’s appearance settings.
  4. Use the CustomizePivotCellEventArgs.ValueItemInfo property to specify the field to which the customized cell belongs.
  5. To export cells with custom formatting, set the Handled parameter to true.
  6. To export customized data from a PivotGrid Control, pass the PivotGridXlsExportOptions instance to the ExportToXls method.

The following example exports data from a PivotGrid Control to Xls format. The PivotGridXlsExportOptions.CustomizeCell event is used to change the background color of the “Category Name” column in the output document.

//...
void op_CustomizeCell(CustomizePivotCellEventArgs e){
       if (e.ValueItemInfo != null && e.ValueItemInfo.Field == fieldCategoryName) 
      {
          e.Formatting.BackColor = Color.AliceBlue;
          e.Handled = true;
      }

  }
void Button_Click(object sender, RoutedEventArgs e) {
    PivotGridXlsExportOptions op = new PivotGridXlsExportOptions();
    op.CustomizeCell += op_CustomizeCell;
    pivorGrid1.ExportToXls(file, op);
}
See Also