IFlexGridXlsxOptions Interface

File
wijmo.grid.xlsx.js
Module
wijmo.grid.xlsx

FlexGrid Xlsx conversion options

Properties

Properties

activeWorksheet

Index or name of the active sheet in the xlsx file.

Type
any

formatItem

An optional callback which is called for every exported cell and allows to perform transformations of exported cell value and style. The callback is called irrespectively of the 'includeCellStyles' property value. It has a single parameter of the XlsxFormatItemEventArgs type that provides both information about the source grid cell and an IWorkbookCell object defining its representation in the exported file, which can be customized in the callback.

Type

includeCellStyles

Indicates whether cells styling should be included in the generated xlsx file.

Type
boolean

includeColumnHeaders

Indicates whether to include column headers as first rows in the generated xlsx file.

Type
boolean

includeColumns

A callback to indicate which columns of FlexGrid need be included or omitted during exporting.

For example:

// This sample excludes the 'country' column from export.
 

// JavaScript
wijmo.grid.xlsx.FlexGridXlsxConverter.save(grid, {
  includeColumns: function(column) {
     return column.binding !== 'country';
  }
}
Type

includeRowHeaders

Indicates whether to include column headers as first rows in the generated xlsx file.

Type
boolean

quickCellStyles

When turned on, decreases the export time by activating the cell styles caching if includeCellStyles property is enabled. In typical scenarios it allows to decrease the export time by several times.

The combination of cell's inline style specific properties, own CSS classes and CSS classes of row containing the cell is used as the cache tag. Before the cell style is calculated, the cache is checked first, and if the style associated with the tag is found there, it's taken from there and doesn't get recalculated.

Using this mode can make the export slower when considerable amount of cells have the unique set of CSS classes and inline styles. Also, when pseudo classes like :first-child and :nth-child are used to style the cells and rows, the cell styles can be determined incorrectly.

The default value is true.

Type
boolean

sheetIndex

The index of the sheet in the workbook. It indicates to import which sheet.

Type
number

sheetName

The name of the sheet. It indicates to import which sheet for importing. If the sheetIndex and sheetName are both setting, the priority of sheetName is higher than sheetIndex. It sets the name of worksheet for exporting.

Type
string

sheetVisible

Export only. Indicates whether the sheet is visible.

**Caveat:** This option must be used with care. In case where you generate an xlsx file with a single invisible sheet, such a file can't be opened by Excel. The only scenario where this option can be set to false is where you use multiple export actions to assemble a multi-sheet workbook using a custom code.

The default value for this option is true.

Type
boolean