com.aspose.cells
Class PivotTable

java.lang.Object
    com.aspose.cells.PivotTable

public class PivotTable 
extends java.lang.Object

public java.lang.String getPivotTableStyleName() / public void setPivotTableStyleName(java.lang.String value)

Gets and sets the pivottable style name.

public int getPivotTableStyleType() / public void setPivotTableStyleType(int value)

Gets and sets the built-in pivot table style. The value of the property is PivotTableStyleType integer constant.

public PivotFieldCollection getColumnFields()

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

public PivotFieldCollection getRowFields()

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

public PivotFieldCollection getPageFields()

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

public 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.

public PivotField getDataField()

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.

public PivotFieldCollection getBaseFields()

Returns a PivotFields object that includes all fields in the PivotTable report

public PivotFilterCollection getPivotFilters()

Returns a PivotFilterCollection object.

public CellArea getColumnRange()

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

public CellArea getRowRange()

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

public 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.

public CellArea getTableRange1()

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

public CellArea getTableRange2()

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

public boolean getColumnGrand() / public void setColumnGrand(boolean value)

Indicates whether the PivotTable report shows grand totals for columns.

public boolean isGridDropZones() / public void setGridDropZones(boolean value)

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

public boolean getRowGrand() / public void setRowGrand(boolean value)

Indicates whether the PivotTable report shows grand totals for rows.

public boolean getDisplayNullString() / public void setDisplayNullString(boolean value)

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

public java.lang.String getNullString() / public void setNullString(java.lang.String value)

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

public boolean getDisplayErrorString() / public void setDisplayErrorString(boolean value)

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

public java.lang.String getErrorString() / public void setErrorString(java.lang.String value)

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

public boolean isAutoFormat() / public void setAutoFormat(boolean value)

Indicates whether the PivotTable report is automatically formatted. Checkbox "autoformat table "which in pivottable option for Excel 2003 Checkbox "autofit column width on update"which in pivot table Options :Layout Format for Excel 2007

public int getAutoFormatType() / public void setAutoFormatType(int value)

Gets the PivotTable auto format type. The value of the property is PivotTableAutoFormatType integer constant.

PivotTableAutoFormatType

public boolean hasBlankRows() / public void setHasBlankRows(boolean value)

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

public boolean getMergeLabels() / public void setMergeLabels(boolean value)

Indicates whether the specified PivotTable report's outer-row item, column item, subtotal, and grand total labels use merged cells.

public boolean getPreserveFormatting() / public void setPreserveFormatting(boolean value)

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

public boolean getShowDrill() / public void setShowDrill(boolean value)

Gets whether expand/collapse buttons is shown.

public boolean getEnableDrilldown() / public void setEnableDrilldown(boolean value)

Gets whether drilldown is enabled.

public boolean getEnableFieldDialog() / public void setEnableFieldDialog(boolean value)

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

public boolean getEnableFieldList() / public void setEnableFieldList(boolean value)

Gets whether enable the field list for the PivotTable.

public boolean getEnableWizard() / public void setEnableWizard(boolean value)

Indicates whether the PivotTable Wizard is available.

public boolean getSubtotalHiddenPageItems() / public void setSubtotalHiddenPageItems(boolean value)

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.

public java.lang.String getGrandTotalName() / public void setGrandTotalName(java.lang.String value)

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

public boolean getManualUpdate() / public void setManualUpdate(boolean value)

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

public boolean isMultipleFieldFilters() / public void setMultipleFieldFilters(boolean value)

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

public int getMissingItemsLimit() / public void setMissingItemsLimit(int value)

Specifies a boolean value that indicates whether the fields of a PivotTable can have multiple filters set on them. The value of the property is PivotMissingItemLimitType integer constant.

public boolean getEnableDataValueEditing() / public void setEnableDataValueEditing(boolean value)

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

public boolean getShowDataTips() / public void setShowDataTips(boolean value)

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

public boolean getShowMemberPropertyTips() / public void setShowMemberPropertyTips(boolean value)

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

public boolean getShowValuesRow() / public void setShowValuesRow(boolean value)

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

public boolean getShowEmptyCol() / public void setShowEmptyCol(boolean value)

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

public boolean getShowEmptyRow() / public void setShowEmptyRow(boolean value)

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

public boolean getFieldListSortAscending() / public void setFieldListSortAscending(boolean value)

Specifies a boolean value that indicates whether fields in the PivotTable are sorted in non-default order in the field list.

public boolean getPrintDrill() / public void setPrintDrill(boolean value)

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

public java.lang.String getAltTextTitle() / public void setAltTextTitle(java.lang.String value)

Gets the title of the alttext

public java.lang.String getAltTextDescription() / public void setAltTextDescription(java.lang.String value)

Gets the description of the alt text

public java.lang.String getName() / public void setName(java.lang.String value)

Gets the name of the PivotTable

public java.lang.String getColumnHeaderCaption() / public void setColumnHeaderCaption(java.lang.String value)

Gets the Column Header Caption of the PivotTable.

public int getIndent() / public void setIndent(int value)

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

public java.lang.String getRowHeaderCaption() / public void setRowHeaderCaption(java.lang.String value)

Gets the Row Header Caption of the PivotTable.

public boolean getShowRowHeaderCaption() / public void setShowRowHeaderCaption(boolean value)

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

public boolean getCustomListSort() / public void setCustomListSort(boolean value)

Indicates whether consider built-in custom list when sort data

public PivotFormatConditionCollection getPivotFormatConditions()

Gets the Format Conditions of the pivot table.

public int getPageFieldOrder() / public void setPageFieldOrder(int value)

Gets the order in which page fields are added to the PivotTable report's layout. The value of the property is PrintOrderType integer constant.

public int getPageFieldWrapCount() / public void setPageFieldWrapCount(int value)

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

public java.lang.String getTag() / public void setTag(java.lang.String value)

Gets a string saved with the PivotTable report.

public boolean getSaveData() / public void setSaveData(boolean value)

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

public boolean getRefreshDataOnOpeningFile() / public void setRefreshDataOnOpeningFile(boolean value)

Indicates whether Refresh Data when Opening File.

public boolean getRefreshDataFlag() / public void setRefreshDataFlag(boolean value)

Indicates whether Refresh Data or not.

public java.lang.String[] getDataSource() / public void setDataSource(java.lang.String[] value)

Gets and sets the data source of the pivot table.

public boolean getItemPrintTitles() / public void setItemPrintTitles(boolean value)

A bit that specifies whether pivot item captions on the row axis are repeated on each printed page for pivot fields in tabular form.

public boolean getPrintTitles() / public void setPrintTitles(boolean value)

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

public boolean getDisplayImmediateItems() / public void setDisplayImmediateItems(boolean value)

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.

public boolean isSelected() / public void setSelected(boolean value)

Indicates whether the PivotTable is selected.

public boolean getShowPivotStyleRowHeader() / public void setShowPivotStyleRowHeader(boolean value)

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

public boolean getShowPivotStyleColumnHeader() / public void setShowPivotStyleColumnHeader(boolean value)

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

public boolean getShowPivotStyleRowStripes() / public void setShowPivotStyleRowStripes(boolean value)

Indicates whether row stripe formatting is applied.

public boolean getShowPivotStyleColumnStripes() / public void setShowPivotStyleColumnStripes(boolean value)

Indicates whether column stripe formatting is applied.

public boolean getShowPivotStyleLastColumn() / public void setShowPivotStyleLastColumn(boolean value)

Indicates whether column stripe formatting is applied.

public boolean saveData()

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

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.SaveData property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public void changeDataSource(java.lang.String[] source)
                     throws java.lang.Exception

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

public java.lang.String[] getSource()

Get pivottable's source data.

public void refreshData()

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

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

public void calculateData()
                  throws java.lang.Exception

Calculates pivottable's data to cells.

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

public void calculateRange()

Calculates pivottable's range.

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

public void formatAll(Style style)

Format all the cell in the pivottable area

Parameters:

style - Style which is to format

public void format(int row, int column, Style style)

Format the cell in the pivottable area

Parameters:

row - RowIndex of the cell

column - Column index of the cell

style - Style which is to format the cell

public boolean printTitles()

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

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.PrintTitles property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean displayImmediateItems()

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.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.DisplayImmediateItems property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public void setAutoGroupField(int baseFieldIndex)

Sets auto field group by the PivotTable.

Parameters:

baseFieldIndex - The row or column field index in the base fields

public void setAutoGroupField(PivotField pivotField)

Sets auto field group by the PivotTable.

Parameters:

pivotField - The row or column field in the specific fields

public void setManualGroupField(int baseFieldIndex, double startVal, double endVal, java.util.ArrayList groupByList, double intervalNum)

Sets manual field group by the PivotTable.

Parameters:

baseFieldIndex - The row or column field index in the base fields

startVal - Specifies the starting value for numeric grouping.

endVal - Specifies the ending value for numeric grouping.

groupByList - Specifies the grouping type list. Specified by PivotTableGroupType

intervalNum - Specifies the interval number group by numeric grouping.

public void setManualGroupField(PivotField pivotField, double startVal, double endVal, java.util.ArrayList groupByList, double intervalNum)

Sets manual field group by the PivotTable.

Parameters:

pivotField - The row or column field in the base fields

startVal - Specifies the starting value for numeric grouping.

endVal - Specifies the ending value for numeric grouping.

groupByList - Specifies the grouping type list. Specified by PivotTableGroupType

intervalNum - Specifies the interval number group by numeric grouping.

public void setManualGroupField(int baseFieldIndex, com.aspose.cells.DateTime startVal, com.aspose.cells.DateTime endVal, java.util.ArrayList groupByList, int intervalNum)

Sets manual field group by the PivotTable.

Parameters:

baseFieldIndex - The row or column field index in the base fields

startVal - Specifies the starting value for date grouping.

endVal - Specifies the ending value for date grouping.

groupByList - Specifies the grouping type list. Specified by PivotTableGroupType

intervalNum - Specifies the interval number group by in days grouping.The number of days must be positive integer of nonzero

public void setManualGroupField(PivotField pivotField, com.aspose.cells.DateTime startVal, com.aspose.cells.DateTime endVal, java.util.ArrayList groupByList, int intervalNum)

Sets manual field group by the PivotTable.

Parameters:

pivotField - The row or column field in the base fields

startVal - Specifies the starting value for date grouping.

endVal - Specifies the ending value for date grouping.

groupByList - Specifies the grouping type list. Specified by PivotTableGroupType

intervalNum - Specifies the interval number group by in days grouping.The number of days must be positive integer of nonzero

public void setUngroup(int baseFieldIndex)

Sets ungroup by the PivotTable

Parameters:

baseFieldIndex - The row or column field index in the base fields

public void setUngroup(PivotField pivotField)

Sets ungroup by the PivotTable

Parameters:

pivotField - The row or column field in the base fields

public void copyStyle(PivotTable pivotTable)

Copies named style from another pivot table.

Parameters:

pivotTable - Source pivot table.

public void removeField(int fieldType, java.lang.String fieldName)

Removes a field from specific field area

removeField(int, com.aspose.cells.PivotField)

Parameters:

fieldType - A PivotFieldType value. The fields area type.

fieldName - The name in the base fields.

public void removeField(int fieldType, int baseFieldIndex)

Removes a field from specific field area

removeField(int, com.aspose.cells.PivotField)

Parameters:

fieldType - A PivotFieldType value. The fields area type.

baseFieldIndex - The field index in the base fields.

public void removeField(int fieldType, PivotField pivotField)

Remove field from specific field area

Parameters:

fieldType - A PivotFieldType value. the fields area type.It could be one of the following values:

PivotFieldType.Row

PivotFieldType.Column

PivotFieldType.Data

PivotFieldType.Page

pivotField - the field in the base fields.

public int addFieldToArea(int fieldType, java.lang.String fieldName)

Adds the field to the specific area.

addFieldToArea(int, com.aspose.cells.PivotField)

Parameters:

fieldType - A PivotFieldType value. The fields area type.

fieldName - The name in the base fields.

Returns:

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

public int addFieldToArea(int fieldType, int baseFieldIndex)

Adds the field to the specific area.

addFieldToArea(int, com.aspose.cells.PivotField)

Parameters:

fieldType - A PivotFieldType value. The fields area type.

baseFieldIndex - The field index in the base fields.

Returns:

The field position in the specific fields.

public int addFieldToArea(int fieldType, PivotField pivotField)

Adds the field to the specific area.

Parameters:

fieldType - A PivotFieldType value. the fields area type.It could be one of the following values:

PivotFieldType.Row

PivotFieldType.Column

PivotFieldType.Data

PivotFieldType.Page

pivotField - the field in the base fields.

Returns:

the field position in the specific fields.

public void addCalculatedField(java.lang.String name, java.lang.String formula, boolean dragToDataArea)

Adds a calclulated field to pivot field.

Parameters:

name - The name of the calculated field

formula - The formula of the calculated field.

dragToDataArea - True,drag this field to data area immediately

public void addCalculatedField(java.lang.String name, java.lang.String formula)

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

Parameters:

name - The name of the calculated field

formula - The formula of the calculated field.

public PivotFieldCollection fields(int fieldType)

Gets the specific fields by the field type.

Parameters:

fieldType - A PivotFieldType value. the field type.

Returns:

the specific fields

public void move(int row, int column)

Moves the PivotTable to a different location in the worksheet.

Parameters:

row - row index.

column - column index.

public void move(java.lang.String destCellName)

Moves the PivotTable to a different location in the worksheet.

Parameters:

destCellName - the dest cell name.

public boolean isColumnGrand()

Indicates whether the PivotTable report shows grand totals for columns.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.ColumnGrand property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean getIsGridDropZones()

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

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotField.IsGridDropZones property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public void setIsGridDropZones(boolean value)

sets whether the PivotTable report displays classic pivottable layout

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotField.IsGridDropZones property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean isRowGrand()

Indicates whether the PivotTable report shows grand totals for rows.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.RowGrand property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean displayNullString()

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

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.DisplayNullString property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean displayErrorString()

Indicates whether the PivotTable report displays a custom string in cells that contain errors. The default value is false.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.DisplayErrorString property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean getHasBlankRows()

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

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotField.HasBlankRows property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean mergeLabels()

Indicates whether the specified PivotTable report's outer-row item, column item, subtotal, and grand total labels use merged cells.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.MergeLabels property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean preserveFormatting()

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

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.PreserveFormatting property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean enableDrilldown()

Gets whether drilldown is enabled.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.EnableDrilldown property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean enableFieldDialog()

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

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.EnableFieldDialog property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean enableFieldList()

Gets whether enable the field list for the PivotTable.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.EnableFieldList property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean enableWizard()

Indicates whether the PivotTable Wizard is available.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.EnableWizard property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean subtotalHiddenPageItems()

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.

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.SubtotalHiddenPageItems property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.

public boolean manualUpdate()

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

NOTE: This member is now obsolete. Instead, please use Aspose.Cells.Pivot.PivotTable.ManualUpdate property. This property will be removed 12 months later since JANUARY 2012. Aspose apologizes for any inconvenience you may have experienced.