5.20193.637
IFlexGridDrawSettings Wijmo API Interface

IFlexGridDrawSettings Interface

Represents the settings used by the FlexGridPdfConverter.draw and FlexGridPdfConverter.drawToPosition methods.

Heirarchy

Properties

Optional customCellContent

customCellContent: boolean

Indicates whether custom cell content and style should be evaluated and exported. If set to true then export logic will retrieve cell content using cell.textContent property, and cell style using getComputedStyle(cell). Default is 'undefined' (i.e. false).

Optional drawDetailRows

drawDetailRows: boolean

Indicates whether to draw detail rows. If set to false then the detail rows will be ignored; otherwise the detail rows will be drawn empty and their content should be drawn manually using formatItem event handler. Default is 'undefined' (i.e. false).

Optional embeddedFonts

embeddedFonts: IPdfFontFile[]

Represents an array of custom fonts that will be embedded into the document.

This sample illustrates how to setup the FlexGridPdfConverter to use two custom fonts, Cuprum-Bold.ttf and Cuprum-Regular.ttf. The first one is applied to the header cells only, while the second one is applied to all the remaining cells.

wijmo.grid.pdf.FlexGridPdfConverter.export(flex, fileName, {
   embeddedFonts: [{
      source: 'resources/ttf/Cuprum-Bold.ttf',
      name: 'cuprum',
      style: 'normal',
      weight: 'bold'
   }, {
      source: 'resources/ttf/Cuprum-Regular.ttf',
      name: 'cuprum',
      style: 'normal',
      weight: 'normal'
   }],
   styles: {
      cellStyle: {
         font: {
            family: 'cuprum'
         }
      },
      headerCellStyle: {
         font: {
            weight: 'bold'
         }
      }
   }
});

Optional exportMode

exportMode: ExportMode

Determines the export mode.

Optional formatItem

formatItem: Function

An optional callback function called for every exported cell that allows to perform transformations of exported cell value and style, or perform a custom drawing.

The function accepts the PdfFormatItemEventArgs class instance as the first argument.

In case of custom drawing the PdfFormatItemEventArgs.cancel property should be set to true to cancel the default cell content drawing, and the PdfFormatItemEventArgs.cancelBorders property should be set to true to cancel the default cell borders drawing.

wijmo.grid.pdf.FlexGridPdfConverter.export(flex, fileName, {
   formatItem: function(args) {
       // Change the background color of the regular cells of "Country" column.
       if (args.panel.cellType === wijmo.grid.CellType.Cell && args.panel.columns[args.col].binding === "country") {
           args.style.backgroundColor = 'blue';
       }
   }
});

Optional maxPages

maxPages: number

Determines the maximum number of pages to export.

Optional progress

progress: Function

An optional function that gives feedback about the progress of a task. The function accepts a single argument, a number changing from 0.0 to 1.0, where the value of 0.0 indicates that the operation has just begun and the value of 1.0 indicates that the operation has completed.

wijmo.grid.pdf.FlexGridPdfConverter.export(flex, fileName, {
   progress: function(value) {
       // Handle the progress here.
   }
});

Optional recalculateStarWidths

recalculateStarWidths: boolean

Indicates whether star-sized columns widths should be recalculated against the PDF page width instead of using the grid's width.

Optional repeatMergedValuesAcrossPages

repeatMergedValuesAcrossPages: boolean

Indicates whether merged values should be repeated across pages when the merged range is split on multiple pages.

Optional styles

Represents the look and feel of an exported FlexGrid.