PivotTable

PivotTable class

Summary description for PivotTable.

class PivotTable;

Methods

MethodDescription
isExcel2003Compatible()Specifies whether the PivotTable is compatible for Excel2003 when refreshing PivotTable, if true, a string must be less than or equal to 255 characters, so if the string is greater than 255 characters, it will be truncated. if false, a string will not have the aforementioned restriction. The default value is true.
setIsExcel2003Compatible(boolean)Specifies whether the PivotTable is compatible for Excel2003 when refreshing PivotTable, if true, a string must be less than or equal to 255 characters, so if the string is greater than 255 characters, it will be truncated. if false, a string will not have the aforementioned restriction. The default value is true.
getRefreshedByWho()Gets the name of the last user who refreshed this PivotTable
getRefreshDate()Gets the last date time when the PivotTable was refreshed.
getPivotTableStyleName()Gets and sets the pivottable style name.
setPivotTableStyleName(string)Gets and sets the pivottable style name.
getPivotTableStyleType()Gets and sets the built-in pivot table style.
setPivotTableStyleType(PivotTableStyleType)Gets and sets the built-in pivot table style.
getColumnFields()Returns a PivotFields object that are currently shown as column fields.
getRowFields()Returns a PivotFields object that are currently shown as row fields.
getPageFields()Returns a PivotFields object that are currently shown as page fields.
getDataFields()Gets a PivotField object that represents all the data fields in a PivotTable. Read-only.It would be init only when there are two or more data fields in the DataPiovtFiels. It only use to add DataPivotField to the PivotTable row/column area . Default is in row area.
getDataField()Gets a PivotField object that represents all the data fields in a PivotTable. Read-only. It would only be created when there are two or more data fields in the Data region. Defaultly it is in row region. You can drag it to the row/column region with PivotTable.AddFieldToArea() method .
getBaseFields()Returns all base pivot fields in the PivotTable.
getPivotFilters()Returns a list of pivot filters.
getColumnRange()Returns a CellArea object that represents the range that contains the column area in the PivotTable report. Read-only.
getRowRange()Returns a CellArea object that represents the range that contains the row area in the PivotTable report. Read-only.
getDataBodyRange()Returns a CellArea object that represents the range that contains the data area in the list between the header row and the insert row. Read-only.
getTableRange1()Returns a CellArea object that represents the range containing the entire PivotTable report, but doesn’t include page fields. Read-only.
getTableRange2()Returns a CellArea object that represents the range containing the entire PivotTable report, includes page fields. Read-only.
getColumnGrand()Indicates whether the PivotTable report shows grand totals for columns.
setColumnGrand(boolean)Indicates whether the PivotTable report shows grand totals for columns.
isGridDropZones()Indicates whether the PivotTable report displays classic pivottable layout. (enables dragging fields in the grid)
setIsGridDropZones(boolean)Indicates whether the PivotTable report displays classic pivottable layout. (enables dragging fields in the grid)
getRowGrand()Indicates whether the PivotTable report shows grand totals for rows.
setRowGrand(boolean)Indicates whether the PivotTable report shows grand totals for rows.
getDisplayNullString()Indicates whether the PivotTable report displays a custom string if the value is null.
setDisplayNullString(boolean)Indicates whether the PivotTable report displays a custom string if the value is null.
getNullString()Gets the string displayed in cells that contain null values when the DisplayNullString property is true.The default value is an empty string.
setNullString(string)Gets the string displayed in cells that contain null values when the DisplayNullString property is true.The default value is an empty string.
getDisplayErrorString()Indicates whether the PivotTable report displays a custom string in cells that contain errors.
setDisplayErrorString(boolean)Indicates whether the PivotTable report displays a custom string in cells that contain errors.
getDataFieldHeaderName()Gets and sets the name of the value area field header in the PivotTable.
setDataFieldHeaderName(string)Gets and sets the name of the value area field header in the PivotTable.
getErrorString()Gets the string displayed in cells that contain errors when the DisplayErrorString property is true.The default value is an empty string.
setErrorString(string)Gets the string displayed in cells that contain errors when the DisplayErrorString property is true.The default value is an empty string.
isAutoFormat()Indicates whether the PivotTable report is automatically formatted. Checkbox “autoformat table " which is in pivottable option for Excel 2003
setIsAutoFormat(boolean)Indicates whether the PivotTable report is automatically formatted. Checkbox “autoformat table " which is in pivottable option for Excel 2003
getAutofitColumnWidthOnUpdate()Indicates whether autofitting column width on update
setAutofitColumnWidthOnUpdate(boolean)Indicates whether autofitting column width on update
getAutoFormatType()Gets and sets the auto format type of PivotTable.
setAutoFormatType(PivotTableAutoFormatType)Gets and sets the auto format type of PivotTable.
getHasBlankRows()Indicates whether to add blank rows. This property only applies for the PivotTable auto format types which needs to add blank rows.
setHasBlankRows(boolean)Indicates whether to add blank rows. This property only applies for the PivotTable auto format types which needs to add blank rows.
getMergeLabels()True if the specified PivotTable report’s outer-row item, column item, subtotal, and grand total labels use merged cells.
setMergeLabels(boolean)True if the specified PivotTable report’s outer-row item, column item, subtotal, and grand total labels use merged cells.
getPreserveFormatting()Indicates whether formatting is preserved when the PivotTable is refreshed or recalculated.
setPreserveFormatting(boolean)Indicates whether formatting is preserved when the PivotTable is refreshed or recalculated.
getShowDrill()Gets and sets whether showing expand/collapse buttons.
setShowDrill(boolean)Gets and sets whether showing expand/collapse buttons.
getEnableDrilldown()Gets whether drilldown is enabled.
setEnableDrilldown(boolean)Gets whether drilldown is enabled.
getEnableFieldDialog()Indicates whether the PivotTable Field dialog box is available when the user double-clicks the PivotTable field.
setEnableFieldDialog(boolean)Indicates whether the PivotTable Field dialog box is available when the user double-clicks the PivotTable field.
getEnableFieldList()Gets whether enable the field list for the PivotTable.
setEnableFieldList(boolean)Gets whether enable the field list for the PivotTable.
getEnableWizard()Indicates whether the PivotTable Wizard is available.
setEnableWizard(boolean)Indicates whether the PivotTable Wizard is available.
getSubtotalHiddenPageItems()Indicates whether hidden page field items in the PivotTable report are included in row and column subtotals, block totals, and grand totals. The default value is False.
setSubtotalHiddenPageItems(boolean)Indicates whether hidden page field items in the PivotTable report are included in row and column subtotals, block totals, and grand totals. The default value is False.
getGrandTotalName()Returns the text string label that is displayed in the grand total column or row heading. The default value is the string “Grand Total”.
setGrandTotalName(string)Returns the text string label that is displayed in the grand total column or row heading. The default value is the string “Grand Total”.
getManualUpdate()Indicates whether the PivotTable report is recalculated only at the user’s request.
setManualUpdate(boolean)Indicates whether the PivotTable report is recalculated only at the user’s request.
isMultipleFieldFilters()Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them.
setIsMultipleFieldFilters(boolean)Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them.
getMissingItemsLimit()Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them.
setMissingItemsLimit(PivotMissingItemLimitType)Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them.
getEnableDataValueEditing()Specifies a boolean value that indicates whether the user is allowed to edit the cells in the data area of the pivottable. Enable cell editing in the values area
setEnableDataValueEditing(boolean)Specifies a boolean value that indicates whether the user is allowed to edit the cells in the data area of the pivottable. Enable cell editing in the values area
getShowDataTips()Specifies a boolean value that indicates whether tooltips should be displayed for PivotTable data cells.
setShowDataTips(boolean)Specifies a boolean value that indicates whether tooltips should be displayed for PivotTable data cells.
getShowMemberPropertyTips()Specifies a boolean value that indicates whether member property information should be omitted from PivotTable tooltips.
setShowMemberPropertyTips(boolean)Specifies a boolean value that indicates whether member property information should be omitted from PivotTable tooltips.
getShowValuesRow()Specifies a boolean value that indicates whether show values row. show the values row
setShowValuesRow(boolean)Specifies a boolean value that indicates whether show values row. show the values row
getShowEmptyCol()Specifies a boolean value that indicates whether to include empty columns in the table
setShowEmptyCol(boolean)Specifies a boolean value that indicates whether to include empty columns in the table
getShowEmptyRow()Specifies a boolean value that indicates whether to include empty rows in the table.
setShowEmptyRow(boolean)Specifies a boolean value that indicates whether to include empty rows in the table.
getFieldListSortAscending()Indicates whether fields in the PivotTable are sorted in non-default order in the field list.
setFieldListSortAscending(boolean)Indicates whether fields in the PivotTable are sorted in non-default order in the field list.
getPrintDrill()Specifies a boolean value that indicates whether drill indicators should be printed. print expand/collapse buttons when displayed on pivottable.
setPrintDrill(boolean)Specifies a boolean value that indicates whether drill indicators should be printed. print expand/collapse buttons when displayed on pivottable.
getAltTextTitle()Gets the title of the altertext
setAltTextTitle(string)Gets the title of the altertext
getAltTextDescription()Gets the description of the alt text
setAltTextDescription(string)Gets the description of the alt text
getName()Gets the name of the PivotTable
setName(string)Gets the name of the PivotTable
getColumnHeaderCaption()Gets the Column Header Caption of the PivotTable.
setColumnHeaderCaption(string)Gets the Column Header Caption of the PivotTable.
getIndent()Specifies the indentation increment for compact axis and can be used to set the Report Layout to Compact Form.
setIndent(number)Specifies the indentation increment for compact axis and can be used to set the Report Layout to Compact Form.
getRowHeaderCaption()Gets the Row Header Caption of the PivotTable.
setRowHeaderCaption(string)Gets the Row Header Caption of the PivotTable.
getShowRowHeaderCaption()Indicates whether row header caption is shown in the PivotTable report Indicates whether Display field captions and filter drop downs
setShowRowHeaderCaption(boolean)Indicates whether row header caption is shown in the PivotTable report Indicates whether Display field captions and filter drop downs
getCustomListSort()Indicates whether consider built-in custom list when sort data
setCustomListSort(boolean)Indicates whether consider built-in custom list when sort data
getPivotFormatConditions()Gets the Format Conditions of the pivot table.
getPageFieldOrder()Gets the order in which page fields are added to the PivotTable report’s layout.
setPageFieldOrder(PrintOrderType)Gets the order in which page fields are added to the PivotTable report’s layout.
getPageFieldWrapCount()Gets the number of page fields in each column or row in the PivotTable report.
setPageFieldWrapCount(number)Gets the number of page fields in each column or row in the PivotTable report.
getTag()Gets a string saved with the PivotTable report.
setTag(string)Gets a string saved with the PivotTable report.
getSaveData()Indicates whether data for the PivotTable report is saved with the workbook.
setSaveData(boolean)Indicates whether data for the PivotTable report is saved with the workbook.
getRefreshDataOnOpeningFile()Indicates whether Refresh Data when Opening File.
setRefreshDataOnOpeningFile(boolean)Indicates whether Refresh Data when Opening File.
getRefreshDataFlag()Indicates whether Refreshing Data or not.
setRefreshDataFlag(boolean)Indicates whether Refreshing Data or not.
getExternalConnectionDataSource()Gets the external connection data source.
getDataSource()Gets and sets the data source of the pivot table.
setDataSource(string[])Gets and sets the data source of the pivot table.
getPivotFormats()Gets the collection of formats applied to PivotTable.
getItemPrintTitles()Indicates whether PivotItem names should be repeated at the top of each printed page.
setItemPrintTitles(boolean)Indicates whether PivotItem names should be repeated at the top of each printed page.
getPrintTitles()Indicates whether the print titles for the worksheet are set based on the PivotTable report. The default value is false.
setPrintTitles(boolean)Indicates whether the print titles for the worksheet are set based on the PivotTable report. The default value is false.
getDisplayImmediateItems()Indicates whether items in the row and column areas are visible when the data area of the PivotTable is empty. The default value is true.
setDisplayImmediateItems(boolean)Indicates whether items in the row and column areas are visible when the data area of the PivotTable is empty. The default value is true.
isSelected()Indicates whether this PivotTable is selected.
setIsSelected(boolean)Indicates whether this PivotTable is selected.
getShowPivotStyleRowHeader()Indicates whether the row header in the pivot table should have the style applied.
setShowPivotStyleRowHeader(boolean)Indicates whether the row header in the pivot table should have the style applied.
getShowPivotStyleColumnHeader()Indicates whether the column header in the pivot table should have the style applied.
setShowPivotStyleColumnHeader(boolean)Indicates whether the column header in the pivot table should have the style applied.
getShowPivotStyleRowStripes()Indicates whether row stripe formatting is applied.
setShowPivotStyleRowStripes(boolean)Indicates whether row stripe formatting is applied.
getShowPivotStyleColumnStripes()Indicates whether stripe formatting is applied for column.
setShowPivotStyleColumnStripes(boolean)Indicates whether stripe formatting is applied for column.
getShowPivotStyleLastColumn()Indicates whether the column formatting is applied.
setShowPivotStyleLastColumn(boolean)Indicates whether the column formatting is applied.
dispose()Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
copyStyle(PivotTable)Copies named style from another pivot table.
showReportFilterPage(PivotField)Show all the report filter pages according to PivotField, the PivotField must be located in the PageFields.
showReportFilterPageByName(string)Show all the report filter pages according to PivotField’s name, the PivotField must be located in the PageFields.
showReportFilterPageByIndex(number)Show all the report filter pages according to the position index in the PageFields
removeField(PivotFieldType, string)Removes a field from specific field area
removeField(PivotFieldType, number)Removes a field from specific field area
removeField(PivotFieldType, PivotField)Remove field from specific field area
addFieldToArea(PivotFieldType, string)Adds the field to the specific area.
addFieldToArea(PivotFieldType, number)Adds the field to the specific area.
addFieldToArea(PivotFieldType, PivotField)Adds the field to the specific area.
addCalculatedField(string, string, boolean)Adds a calculated field to pivot field.
addCalculatedField(string, string)Adds a calculated field to pivot field and drag it to data area.
getFields(PivotFieldType)Gets the specific pivot field list by the region.
move(number, number)Moves the PivotTable to a different location in the worksheet.
move(string)Moves the PivotTable to a different location in the worksheet.
changeDataSource(string[])Set pivottable’s source data. Sheet1!$A$1:$C$3
getSource()Get pivottable’s source data.
refreshData()Refreshes pivottable’s data and setting from it’s data source.
refreshData(PivotTableRefreshOption)Refreshes pivottable’s data and setting from it’s data source with options.
calculateData()Calculates pivottable’s data to cells.
calculateData(PivotTableCalculateOption)Calculating pivot tables with options
clearData()Clear PivotTable’s data and formatting
calculateRange()Calculates pivottable’s range.
formatAll(Style)Format all the cell in the pivottable area
formatRow(number, Style)Format the row data in the pivottable area
format(PivotArea, Style)Formats selected area of the PivotTable.
format(number, number, Style)Format the cell in the pivottable area
showInCompactForm()Layouts the PivotTable in compact form.
showInOutlineForm()Layouts the PivotTable in outline form.
showInTabularForm()Layouts the PivotTable in tabular form.
getCellByDisplayName(string)Gets the Cell object by the display name of PivotField.
getChildren()Gets the Children Pivot Tables which use this PivotTable data as data source.

isExcel2003Compatible()

Specifies whether the PivotTable is compatible for Excel2003 when refreshing PivotTable, if true, a string must be less than or equal to 255 characters, so if the string is greater than 255 characters, it will be truncated. if false, a string will not have the aforementioned restriction. The default value is true.

isExcel2003Compatible() : boolean;

setIsExcel2003Compatible(boolean)

Specifies whether the PivotTable is compatible for Excel2003 when refreshing PivotTable, if true, a string must be less than or equal to 255 characters, so if the string is greater than 255 characters, it will be truncated. if false, a string will not have the aforementioned restriction. The default value is true.

setIsExcel2003Compatible(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getRefreshedByWho()

Gets the name of the last user who refreshed this PivotTable

getRefreshedByWho() : string;

getRefreshDate()

Gets the last date time when the PivotTable was refreshed.

getRefreshDate() : Date;

getPivotTableStyleName()

Gets and sets the pivottable style name.

getPivotTableStyleName() : string;

setPivotTableStyleName(string)

Gets and sets the pivottable style name.

setPivotTableStyleName(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getPivotTableStyleType()

Gets and sets the built-in pivot table style.

getPivotTableStyleType() : PivotTableStyleType;

Returns

PivotTableStyleType

setPivotTableStyleType(PivotTableStyleType)

Gets and sets the built-in pivot table style.

setPivotTableStyleType(value: PivotTableStyleType) : void;

Parameters:

ParameterTypeDescription
valuePivotTableStyleTypeThe value to set.

getColumnFields()

Returns a PivotFields object that are currently shown as column fields.

getColumnFields() : PivotFieldCollection;

Returns

PivotFieldCollection

getRowFields()

Returns a PivotFields object that are currently shown as row fields.

getRowFields() : PivotFieldCollection;

Returns

PivotFieldCollection

getPageFields()

Returns a PivotFields object that are currently shown as page fields.

getPageFields() : PivotFieldCollection;

Returns

PivotFieldCollection

getDataFields()

Gets a PivotField object that represents all the data fields in a PivotTable. Read-only.It would be init only when there are two or more data fields in the DataPiovtFiels. It only use to add DataPivotField to the PivotTable row/column area . Default is in row area.

getDataFields() : PivotFieldCollection;

Returns

PivotFieldCollection

getDataField()

Gets a PivotField object that represents all the data fields in a PivotTable. Read-only. It would only be created when there are two or more data fields in the Data region. Defaultly it is in row region. You can drag it to the row/column region with PivotTable.AddFieldToArea() method .

getDataField() : PivotField;

Returns

PivotField

getBaseFields()

Returns all base pivot fields in the PivotTable.

getBaseFields() : PivotFieldCollection;

Returns

PivotFieldCollection

getPivotFilters()

Returns a list of pivot filters.

getPivotFilters() : PivotFilterCollection;

Returns

PivotFilterCollection

getColumnRange()

Returns a CellArea object that represents the range that contains the column area in the PivotTable report. Read-only.

getColumnRange() : CellArea;

Returns

CellArea

getRowRange()

Returns a CellArea object that represents the range that contains the row area in the PivotTable report. Read-only.

getRowRange() : CellArea;

Returns

CellArea

getDataBodyRange()

Returns a CellArea object that represents the range that contains the data area in the list between the header row and the insert row. Read-only.

getDataBodyRange() : CellArea;

Returns

CellArea

getTableRange1()

Returns a CellArea object that represents the range containing the entire PivotTable report, but doesn’t include page fields. Read-only.

getTableRange1() : CellArea;

Returns

CellArea

getTableRange2()

Returns a CellArea object that represents the range containing the entire PivotTable report, includes page fields. Read-only.

getTableRange2() : CellArea;

Returns

CellArea

getColumnGrand()

Indicates whether the PivotTable report shows grand totals for columns.

getColumnGrand() : boolean;

setColumnGrand(boolean)

Indicates whether the PivotTable report shows grand totals for columns.

setColumnGrand(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

isGridDropZones()

Indicates whether the PivotTable report displays classic pivottable layout. (enables dragging fields in the grid)

isGridDropZones() : boolean;

setIsGridDropZones(boolean)

Indicates whether the PivotTable report displays classic pivottable layout. (enables dragging fields in the grid)

setIsGridDropZones(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getRowGrand()

Indicates whether the PivotTable report shows grand totals for rows.

getRowGrand() : boolean;

setRowGrand(boolean)

Indicates whether the PivotTable report shows grand totals for rows.

setRowGrand(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getDisplayNullString()

Indicates whether the PivotTable report displays a custom string if the value is null.

getDisplayNullString() : boolean;

setDisplayNullString(boolean)

Indicates whether the PivotTable report displays a custom string if the value is null.

setDisplayNullString(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getNullString()

Gets the string displayed in cells that contain null values when the DisplayNullString property is true.The default value is an empty string.

getNullString() : string;

setNullString(string)

Gets the string displayed in cells that contain null values when the DisplayNullString property is true.The default value is an empty string.

setNullString(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getDisplayErrorString()

Indicates whether the PivotTable report displays a custom string in cells that contain errors.

getDisplayErrorString() : boolean;

setDisplayErrorString(boolean)

Indicates whether the PivotTable report displays a custom string in cells that contain errors.

setDisplayErrorString(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getDataFieldHeaderName()

Gets and sets the name of the value area field header in the PivotTable.

getDataFieldHeaderName() : string;

setDataFieldHeaderName(string)

Gets and sets the name of the value area field header in the PivotTable.

setDataFieldHeaderName(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getErrorString()

Gets the string displayed in cells that contain errors when the DisplayErrorString property is true.The default value is an empty string.

getErrorString() : string;

setErrorString(string)

Gets the string displayed in cells that contain errors when the DisplayErrorString property is true.The default value is an empty string.

setErrorString(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

isAutoFormat()

Indicates whether the PivotTable report is automatically formatted. Checkbox “autoformat table " which is in pivottable option for Excel 2003

isAutoFormat() : boolean;

setIsAutoFormat(boolean)

Indicates whether the PivotTable report is automatically formatted. Checkbox “autoformat table " which is in pivottable option for Excel 2003

setIsAutoFormat(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getAutofitColumnWidthOnUpdate()

Indicates whether autofitting column width on update

getAutofitColumnWidthOnUpdate() : boolean;

setAutofitColumnWidthOnUpdate(boolean)

Indicates whether autofitting column width on update

setAutofitColumnWidthOnUpdate(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getAutoFormatType()

Gets and sets the auto format type of PivotTable.

getAutoFormatType() : PivotTableAutoFormatType;

Returns

PivotTableAutoFormatType

setAutoFormatType(PivotTableAutoFormatType)

Gets and sets the auto format type of PivotTable.

setAutoFormatType(value: PivotTableAutoFormatType) : void;

Parameters:

ParameterTypeDescription
valuePivotTableAutoFormatTypeThe value to set.

getHasBlankRows()

Indicates whether to add blank rows. This property only applies for the PivotTable auto format types which needs to add blank rows.

getHasBlankRows() : boolean;

setHasBlankRows(boolean)

Indicates whether to add blank rows. This property only applies for the PivotTable auto format types which needs to add blank rows.

setHasBlankRows(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getMergeLabels()

True if the specified PivotTable report’s outer-row item, column item, subtotal, and grand total labels use merged cells.

getMergeLabels() : boolean;

setMergeLabels(boolean)

True if the specified PivotTable report’s outer-row item, column item, subtotal, and grand total labels use merged cells.

setMergeLabels(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getPreserveFormatting()

Indicates whether formatting is preserved when the PivotTable is refreshed or recalculated.

getPreserveFormatting() : boolean;

setPreserveFormatting(boolean)

Indicates whether formatting is preserved when the PivotTable is refreshed or recalculated.

setPreserveFormatting(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowDrill()

Gets and sets whether showing expand/collapse buttons.

getShowDrill() : boolean;

setShowDrill(boolean)

Gets and sets whether showing expand/collapse buttons.

setShowDrill(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getEnableDrilldown()

Gets whether drilldown is enabled.

getEnableDrilldown() : boolean;

setEnableDrilldown(boolean)

Gets whether drilldown is enabled.

setEnableDrilldown(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getEnableFieldDialog()

Indicates whether the PivotTable Field dialog box is available when the user double-clicks the PivotTable field.

getEnableFieldDialog() : boolean;

setEnableFieldDialog(boolean)

Indicates whether the PivotTable Field dialog box is available when the user double-clicks the PivotTable field.

setEnableFieldDialog(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getEnableFieldList()

Gets whether enable the field list for the PivotTable.

getEnableFieldList() : boolean;

setEnableFieldList(boolean)

Gets whether enable the field list for the PivotTable.

setEnableFieldList(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getEnableWizard()

Indicates whether the PivotTable Wizard is available.

getEnableWizard() : boolean;

setEnableWizard(boolean)

Indicates whether the PivotTable Wizard is available.

setEnableWizard(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getSubtotalHiddenPageItems()

Indicates whether hidden page field items in the PivotTable report are included in row and column subtotals, block totals, and grand totals. The default value is False.

getSubtotalHiddenPageItems() : boolean;

setSubtotalHiddenPageItems(boolean)

Indicates whether hidden page field items in the PivotTable report are included in row and column subtotals, block totals, and grand totals. The default value is False.

setSubtotalHiddenPageItems(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getGrandTotalName()

Returns the text string label that is displayed in the grand total column or row heading. The default value is the string “Grand Total”.

getGrandTotalName() : string;

setGrandTotalName(string)

Returns the text string label that is displayed in the grand total column or row heading. The default value is the string “Grand Total”.

setGrandTotalName(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getManualUpdate()

Indicates whether the PivotTable report is recalculated only at the user’s request.

getManualUpdate() : boolean;

setManualUpdate(boolean)

Indicates whether the PivotTable report is recalculated only at the user’s request.

setManualUpdate(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

isMultipleFieldFilters()

Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them.

isMultipleFieldFilters() : boolean;

setIsMultipleFieldFilters(boolean)

Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them.

setIsMultipleFieldFilters(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getMissingItemsLimit()

Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them.

getMissingItemsLimit() : PivotMissingItemLimitType;

Returns

PivotMissingItemLimitType

setMissingItemsLimit(PivotMissingItemLimitType)

Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them.

setMissingItemsLimit(value: PivotMissingItemLimitType) : void;

Parameters:

ParameterTypeDescription
valuePivotMissingItemLimitTypeThe value to set.

getEnableDataValueEditing()

Specifies a boolean value that indicates whether the user is allowed to edit the cells in the data area of the pivottable. Enable cell editing in the values area

getEnableDataValueEditing() : boolean;

setEnableDataValueEditing(boolean)

Specifies a boolean value that indicates whether the user is allowed to edit the cells in the data area of the pivottable. Enable cell editing in the values area

setEnableDataValueEditing(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowDataTips()

Specifies a boolean value that indicates whether tooltips should be displayed for PivotTable data cells.

getShowDataTips() : boolean;

setShowDataTips(boolean)

Specifies a boolean value that indicates whether tooltips should be displayed for PivotTable data cells.

setShowDataTips(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowMemberPropertyTips()

Specifies a boolean value that indicates whether member property information should be omitted from PivotTable tooltips.

getShowMemberPropertyTips() : boolean;

setShowMemberPropertyTips(boolean)

Specifies a boolean value that indicates whether member property information should be omitted from PivotTable tooltips.

setShowMemberPropertyTips(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowValuesRow()

Specifies a boolean value that indicates whether show values row. show the values row

getShowValuesRow() : boolean;

setShowValuesRow(boolean)

Specifies a boolean value that indicates whether show values row. show the values row

setShowValuesRow(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowEmptyCol()

Specifies a boolean value that indicates whether to include empty columns in the table

getShowEmptyCol() : boolean;

setShowEmptyCol(boolean)

Specifies a boolean value that indicates whether to include empty columns in the table

setShowEmptyCol(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowEmptyRow()

Specifies a boolean value that indicates whether to include empty rows in the table.

getShowEmptyRow() : boolean;

setShowEmptyRow(boolean)

Specifies a boolean value that indicates whether to include empty rows in the table.

setShowEmptyRow(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getFieldListSortAscending()

Indicates whether fields in the PivotTable are sorted in non-default order in the field list.

getFieldListSortAscending() : boolean;

setFieldListSortAscending(boolean)

Indicates whether fields in the PivotTable are sorted in non-default order in the field list.

setFieldListSortAscending(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getPrintDrill()

Specifies a boolean value that indicates whether drill indicators should be printed. print expand/collapse buttons when displayed on pivottable.

getPrintDrill() : boolean;

setPrintDrill(boolean)

Specifies a boolean value that indicates whether drill indicators should be printed. print expand/collapse buttons when displayed on pivottable.

setPrintDrill(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getAltTextTitle()

Gets the title of the altertext

getAltTextTitle() : string;

setAltTextTitle(string)

Gets the title of the altertext

setAltTextTitle(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getAltTextDescription()

Gets the description of the alt text

getAltTextDescription() : string;

setAltTextDescription(string)

Gets the description of the alt text

setAltTextDescription(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getName()

Gets the name of the PivotTable

getName() : string;

setName(string)

Gets the name of the PivotTable

setName(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getColumnHeaderCaption()

Gets the Column Header Caption of the PivotTable.

getColumnHeaderCaption() : string;

setColumnHeaderCaption(string)

Gets the Column Header Caption of the PivotTable.

setColumnHeaderCaption(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getIndent()

Specifies the indentation increment for compact axis and can be used to set the Report Layout to Compact Form.

getIndent() : number;

setIndent(number)

Specifies the indentation increment for compact axis and can be used to set the Report Layout to Compact Form.

setIndent(value: number) : void;

Parameters:

ParameterTypeDescription
valuenumberThe value to set.

getRowHeaderCaption()

Gets the Row Header Caption of the PivotTable.

getRowHeaderCaption() : string;

setRowHeaderCaption(string)

Gets the Row Header Caption of the PivotTable.

setRowHeaderCaption(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getShowRowHeaderCaption()

Indicates whether row header caption is shown in the PivotTable report Indicates whether Display field captions and filter drop downs

getShowRowHeaderCaption() : boolean;

setShowRowHeaderCaption(boolean)

Indicates whether row header caption is shown in the PivotTable report Indicates whether Display field captions and filter drop downs

setShowRowHeaderCaption(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getCustomListSort()

Indicates whether consider built-in custom list when sort data

getCustomListSort() : boolean;

setCustomListSort(boolean)

Indicates whether consider built-in custom list when sort data

setCustomListSort(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getPivotFormatConditions()

Gets the Format Conditions of the pivot table.

getPivotFormatConditions() : PivotFormatConditionCollection;

Returns

PivotFormatConditionCollection

getPageFieldOrder()

Gets the order in which page fields are added to the PivotTable report’s layout.

getPageFieldOrder() : PrintOrderType;

Returns

PrintOrderType

setPageFieldOrder(PrintOrderType)

Gets the order in which page fields are added to the PivotTable report’s layout.

setPageFieldOrder(value: PrintOrderType) : void;

Parameters:

ParameterTypeDescription
valuePrintOrderTypeThe value to set.

getPageFieldWrapCount()

Gets the number of page fields in each column or row in the PivotTable report.

getPageFieldWrapCount() : number;

setPageFieldWrapCount(number)

Gets the number of page fields in each column or row in the PivotTable report.

setPageFieldWrapCount(value: number) : void;

Parameters:

ParameterTypeDescription
valuenumberThe value to set.

getTag()

Gets a string saved with the PivotTable report.

getTag() : string;

setTag(string)

Gets a string saved with the PivotTable report.

setTag(value: string) : void;

Parameters:

ParameterTypeDescription
valuestringThe value to set.

getSaveData()

Indicates whether data for the PivotTable report is saved with the workbook.

getSaveData() : boolean;

setSaveData(boolean)

Indicates whether data for the PivotTable report is saved with the workbook.

setSaveData(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getRefreshDataOnOpeningFile()

Indicates whether Refresh Data when Opening File.

getRefreshDataOnOpeningFile() : boolean;

setRefreshDataOnOpeningFile(boolean)

Indicates whether Refresh Data when Opening File.

setRefreshDataOnOpeningFile(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getRefreshDataFlag()

Indicates whether Refreshing Data or not.

getRefreshDataFlag() : boolean;

setRefreshDataFlag(boolean)

Indicates whether Refreshing Data or not.

setRefreshDataFlag(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getExternalConnectionDataSource()

Gets the external connection data source.

getExternalConnectionDataSource() : ExternalConnection;

Returns

ExternalConnection

getDataSource()

Gets and sets the data source of the pivot table.

getDataSource() : string[];

Returns

string[]

setDataSource(string[])

Gets and sets the data source of the pivot table.

setDataSource(value: string[]) : void;

Parameters:

ParameterTypeDescription
valuestring[]The value to set.

getPivotFormats()

Gets the collection of formats applied to PivotTable.

getPivotFormats() : PivotTableFormatCollection;

Returns

PivotTableFormatCollection

getItemPrintTitles()

Indicates whether PivotItem names should be repeated at the top of each printed page.

getItemPrintTitles() : boolean;

setItemPrintTitles(boolean)

Indicates whether PivotItem names should be repeated at the top of each printed page.

setItemPrintTitles(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getPrintTitles()

Indicates whether the print titles for the worksheet are set based on the PivotTable report. The default value is false.

getPrintTitles() : boolean;

setPrintTitles(boolean)

Indicates whether the print titles for the worksheet are set based on the PivotTable report. The default value is false.

setPrintTitles(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getDisplayImmediateItems()

Indicates whether items in the row and column areas are visible when the data area of the PivotTable is empty. The default value is true.

getDisplayImmediateItems() : boolean;

setDisplayImmediateItems(boolean)

Indicates whether items in the row and column areas are visible when the data area of the PivotTable is empty. The default value is true.

setDisplayImmediateItems(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

isSelected()

Indicates whether this PivotTable is selected.

isSelected() : boolean;

setIsSelected(boolean)

Indicates whether this PivotTable is selected.

setIsSelected(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowPivotStyleRowHeader()

Indicates whether the row header in the pivot table should have the style applied.

getShowPivotStyleRowHeader() : boolean;

setShowPivotStyleRowHeader(boolean)

Indicates whether the row header in the pivot table should have the style applied.

setShowPivotStyleRowHeader(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowPivotStyleColumnHeader()

Indicates whether the column header in the pivot table should have the style applied.

getShowPivotStyleColumnHeader() : boolean;

setShowPivotStyleColumnHeader(boolean)

Indicates whether the column header in the pivot table should have the style applied.

setShowPivotStyleColumnHeader(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowPivotStyleRowStripes()

Indicates whether row stripe formatting is applied.

getShowPivotStyleRowStripes() : boolean;

setShowPivotStyleRowStripes(boolean)

Indicates whether row stripe formatting is applied.

setShowPivotStyleRowStripes(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowPivotStyleColumnStripes()

Indicates whether stripe formatting is applied for column.

getShowPivotStyleColumnStripes() : boolean;

setShowPivotStyleColumnStripes(boolean)

Indicates whether stripe formatting is applied for column.

setShowPivotStyleColumnStripes(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getShowPivotStyleLastColumn()

Indicates whether the column formatting is applied.

getShowPivotStyleLastColumn() : boolean;

setShowPivotStyleLastColumn(boolean)

Indicates whether the column formatting is applied.

setShowPivotStyleLastColumn(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

dispose() : void;

copyStyle(PivotTable)

Copies named style from another pivot table.

copyStyle(pivotTable: PivotTable) : void;

Parameters:

ParameterTypeDescription
pivotTablePivotTableSource pivot table.

showReportFilterPage(PivotField)

Show all the report filter pages according to PivotField, the PivotField must be located in the PageFields.

showReportFilterPage(pageField: PivotField) : void;

Parameters:

ParameterTypeDescription
pageFieldPivotFieldThe PivotField object

showReportFilterPageByName(string)

Show all the report filter pages according to PivotField’s name, the PivotField must be located in the PageFields.

showReportFilterPageByName(fieldName: string) : void;

Parameters:

ParameterTypeDescription
fieldNamestringThe name of PivotField

showReportFilterPageByIndex(number)

Show all the report filter pages according to the position index in the PageFields

showReportFilterPageByIndex(posIndex: number) : void;

Parameters:

ParameterTypeDescription
posIndexnumberThe position index in the PageFields

removeField(PivotFieldType, string)

Removes a field from specific field area

removeField(fieldType: PivotFieldType, fieldName: string) : void;

Parameters:

ParameterTypeDescription
fieldTypePivotFieldTypeThe fields area type.
fieldNamestringThe name in the base fields.

removeField(PivotFieldType, number)

Removes a field from specific field area

removeField(fieldType: PivotFieldType, baseFieldIndex: number) : void;

Parameters:

ParameterTypeDescription
fieldTypePivotFieldTypeThe fields area type.
baseFieldIndexnumberThe field index in the base fields.

removeField(PivotFieldType, PivotField)

Remove field from specific field area

removeField(fieldType: PivotFieldType, pivotField: PivotField) : void;

Parameters:

ParameterTypeDescription
fieldTypePivotFieldTypethe fields area type.
pivotFieldPivotFieldthe field in the base fields.

addFieldToArea(PivotFieldType, string)

Adds the field to the specific area.

addFieldToArea(fieldType: PivotFieldType, fieldName: string) : number;

Parameters:

ParameterTypeDescription
fieldTypePivotFieldTypeThe fields area type.
fieldNamestringThe name in the base fields.

Returns

The field position in the specific fields.If there is no field named as it, return -1.

addFieldToArea(PivotFieldType, number)

Adds the field to the specific area.

addFieldToArea(fieldType: PivotFieldType, baseFieldIndex: number) : number;

Parameters:

ParameterTypeDescription
fieldTypePivotFieldTypeThe fields area type.
baseFieldIndexnumberThe field index in the base fields.

Returns

The field position in the specific fields.

addFieldToArea(PivotFieldType, PivotField)

Adds the field to the specific area.

addFieldToArea(fieldType: PivotFieldType, pivotField: PivotField) : number;

Parameters:

ParameterTypeDescription
fieldTypePivotFieldTypethe fields area type.
pivotFieldPivotFieldthe field in the base fields.

Returns

the field position in the specific fields.

addCalculatedField(string, string, boolean)

Adds a calculated field to pivot field.

addCalculatedField(name: string, formula: string, dragToDataArea: boolean) : void;

Parameters:

ParameterTypeDescription
namestringThe name of the calculated field
formulastringThe formula of the calculated field.
dragToDataAreabooleanTrue,drag this field to data area immediately

addCalculatedField(string, string)

Adds a calculated field to pivot field and drag it to data area.

addCalculatedField(name: string, formula: string) : void;

Parameters:

ParameterTypeDescription
namestringThe name of the calculated field
formulastringThe formula of the calculated field.

getFields(PivotFieldType)

Gets the specific pivot field list by the region.

getFields(fieldType: PivotFieldType) : PivotFieldCollection;

Parameters:

ParameterTypeDescription
fieldTypePivotFieldTypethe region type.

Returns

the specific pivot field collection

move(number, number)

Moves the PivotTable to a different location in the worksheet.

move(row: number, column: number) : void;

Parameters:

ParameterTypeDescription
rownumberrow index.
columnnumbercolumn index.

move(string)

Moves the PivotTable to a different location in the worksheet.

move(destCellName: string) : void;

Parameters:

ParameterTypeDescription
destCellNamestringthe dest cell name.

changeDataSource(string[])

Set pivottable’s source data. Sheet1!$A$1:$C$3

changeDataSource(source: string[]) : void;

Parameters:

ParameterTypeDescription
sourcestring[]

getSource()

Get pivottable’s source data.

getSource() : string[];

Returns

string[]

refreshData()

Refreshes pivottable’s data and setting from it’s data source.

refreshData() : void;

Remarks

We will gather data from data source to a pivot cache ,then calculate the data in the cache to the cells. This method is only used to gather all data to a pivot cache.

refreshData(PivotTableRefreshOption)

Refreshes pivottable’s data and setting from it’s data source with options.

refreshData(option: PivotTableRefreshOption) : void;

Parameters:

ParameterTypeDescription
optionPivotTableRefreshOptionThe options for refreshing data source of pivot table.

calculateData()

Calculates pivottable’s data to cells.

calculateData() : void;

Remarks

Cell.Value in the pivot range could not return the correct result if the method is not been called. This method calculates data with an inner pivot cache,not original data source. So if the data source is changed, please call RefreshData() method first.

calculateData(PivotTableCalculateOption)

Calculating pivot tables with options

calculateData(option: PivotTableCalculateOption) : void;

Parameters:

ParameterTypeDescription
optionPivotTableCalculateOption

clearData()

Clear PivotTable’s data and formatting

clearData() : void;

Remarks

If this method is not called before you add or delete PivotField, Maybe the PivotTable data is not corrected

calculateRange()

Calculates pivottable’s range.

calculateRange() : void;

Remarks

If this method is not been called,maybe the pivottable range is not corrected.

formatAll(Style)

Format all the cell in the pivottable area

formatAll(style: Style) : void;

Parameters:

ParameterTypeDescription
styleStyleStyle which is to format

formatRow(number, Style)

Format the row data in the pivottable area

formatRow(row: number, style: Style) : void;

Parameters:

ParameterTypeDescription
rownumberRow Index of the Row object
styleStyleStyle which is to format

format(PivotArea, Style)

Formats selected area of the PivotTable.

format(pivotArea: PivotArea, style: Style) : void;

Parameters:

ParameterTypeDescription
pivotAreaPivotArea
styleStyle

format(number, number, Style)

Format the cell in the pivottable area

format(row: number, column: number, style: Style) : void;

Parameters:

ParameterTypeDescription
rownumberRow Index of the cell
columnnumberColumn index of the cell
styleStyleStyle which is to format the cell

showInCompactForm()

Layouts the PivotTable in compact form.

showInCompactForm() : void;

showInOutlineForm()

Layouts the PivotTable in outline form.

showInOutlineForm() : void;

showInTabularForm()

Layouts the PivotTable in tabular form.

showInTabularForm() : void;

getCellByDisplayName(string)

Gets the Cell object by the display name of PivotField.

getCellByDisplayName(displayName: string) : Cell;

Parameters:

ParameterTypeDescription
displayNamestringthe DisplayName of PivotField

Returns

the Cell object

getChildren()

Gets the Children Pivot Tables which use this PivotTable data as data source.

getChildren() : PivotTable[];

Returns

the PivotTable array object