Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

PivotGridXlsExportOptions.CustomizeCell Event

In This Article

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.v24.2.dll

NuGet Package: DevExpress.Wpf.PivotGrid

#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