RowExporting Event

Occurs before a grid row is exported to a report.

[Visual Basic]
Public Event RowExporting() As EventHandler(Of RowExportingEventArgs)

[C#]
public event EventHandler<RowExportingEventArgs> RowExporting();

Remarks

The GridRow argument returns the grid row which is being exported. Note that this row exists in the cloned export layout, so any changes made to this row will affect the export without affecting the on-screen grid. This row may not have the same state information (such as the Selected or Expanded state) as the actual grid row in the on-screen grid. To get the on-screen row associated with this row, use the GetRowFromPrintRow method.

ContainingTable returns the ITable in the report to which the row will be exported.

This event is fired before each row is exported. This includes the row, it's cells, it's RowPreviewArea, and may also include column header if using RowLayout mode with column headers that are displayed with the cells. Use the Cancel argument to cancel the default exporting of this row.

This event fires only for normal data rows or GroupBy rows. It does not fire for header or summary rows. For header rows, use UltraGridDocumentExporter.HeaderRowExporting. For summary rows, use UltraGridDocumentExporter.SummaryRowExporting.

Using these event arguments, it is possible to override the exporting of a row and provide a custom export. Typically, this would be done by setting Cancel to true, adding a row to the reportTable, and then populating that row with the desired contents.

See Also

UltraGridDocumentExporter Class  | UltraGridDocumentExporter Members  | RowExported Event  | HeaderRowExporting Event  | SummaryRowExporting Event