WPS 基础接口 > 表格 API 参考 > PivotTable > PivotTable 对象成员

代表工作表上的数据透视表。

方法

?名称说明
AddDataField将数据字段添加到数据透视表中。返回一个 PivotField 对象,该对象表示新的数据字段。
AddFields向数据透视表或数据透视图中添加行字段、列字段和页字段。
AllocateChanges在基于 OLAP 数据源的数据透视表中的所有已编辑的单元格上执行回写操作。
CalculatedFields返回一个 CalculatedFields 集合,该集合代表指定数据透视表中的所有计算字段。只读。
ChangeConnection更改指定 PivotTable 的连接。
ChangePivotCache更改指定 PivotTablePivotCache
ClearAllFiltersClearAllFilters 方法将删除当前应用于数据透视表的所有筛选。包括删除 PivotTable 对象的 PivotFilters 集合中的所有筛选,删除应用的所有手动筛选以及将报表筛选区域中的所有筛选字段设置为默认项。
ClearTableClearTable 方法用于清除数据透视表。清除数据透视表包括删除所有字段以及删除应用于数据透视表的所有筛选和排序。此方法将数据透视表重置为该表刚创建而尚未添加任何字段时的状态。
CommitChanges在基于 OLAP 数据源的数据透视表的数据源上执行提交操作。
ConvertToFormulasConvertToFormulas 方法是 ET 中的新方法,可用于将数据透视表转换为多维数据集公式。可读/写 Boolean 类型。
CreateCubeFile创建数据透视表的多维数据集文件,该数据透视表与联机分析处理 (OLAP)?(OLAP:为查询和报表(而不是处理事务)而进行了优化的数据库技术。OLAP 数据是按分级结构组织的,它存储在多维数据集而不是表中。) 数据源相连接。
DiscardChanges放弃数据透视表的已编辑的单元格中的所有更改。
GetData返回数据透视表中数据字段的值。
GetPivotData返回一个 Range 对象,该对象带有数据透视表中数据项的相关信息。
ListFormulas在分离工作表上创建数据透视表的计算项和计算字段的列表。
PivotCache返回一个 PivotCache 对象,该对象代表指定数据透视表的缓存。只读。
PivotFields返回一个对象,该对象表示数据透视表中单个字段(PivotField 对象)或可见及隐藏字段集合(PivotFields 对象)。只读。
PivotSelect选定数据透视表的一部分。
PivotTableWizard创建并返回一个 PivotTable 对象。此方法不显示“数据透视表向导”,它不适用于 OLE DB 数据源。请使用 Add 方法添加数据透视表缓存,然后创建基于该缓存的数据透视表。
RefreshDataSourceValues针对处于回写模式的数据透视表中的所有已编辑的单元格,从数据源中检索当前值。
RefreshTable用源数据刷新数据透视表。如果成功,则该值为 True
RepeatAllLabels指定在指定的数据透视表中是否为所有 PivotField 重复项目标签。
RowAxisLayout此方法用于同时为所有现有的透视字段设置版式选项。
ShowPages为页字段中的每个数据项创建新的数据透视表。每个新报表都创建在新的工作表上。
SubtotalLocation此方法可更改所有现有透视字段的分类汇总位置。更改分类汇总位置仅对大纲形式的字段产生直接的视觉效果,但是也会对表格形式的字段设置该方法。
Update更新数据透视表。

属性

?名称说明
ActiveFilters指示指定数据透视表中的当前活动的筛选。只读。
Allocation返回或设置在对基于 OLAP 数据源的数据透视表执行模拟分析时,是为编辑过的每个单元格运行 UPDATE CUBE 语句,还是仅在用户选择计算更改时运行该语句。可读写。
AllocationMethod返回或设置在对基于 OLAP 数据源的数据透视表执行模拟分析时用于分配值的方法。可读写。
AllocationValue返回或设置在对基于 OLAP 数据源的数据透视表执行模拟分析时分配的值。可读写。
AllocationWeightExpression返回或设置在对基于 OLAP 数据源的数据透视表执行模拟分析时使用的 MDX 加权表达式。可读写。
AllowMultipleFilters设置或检索一个值,该值指示是否可同时将多个筛选应用于一个透视字段。可读写 Boolean 类型。
AlternativeText返回或设置指定数据透视表的说明性(可选)文本字符串。可读写。
Application如果不使用对象识别符,则该属性返回一个代表 ET 应用程序的 Application 对象。如果使用对象识别符,则该属性返回一个代表指定对象的创建程序的 Application 对象(可对一个 OLE 自动化对象使用该属性来返回该对象的应用程序)。只读。
CacheIndex返回或设置数据透视表缓存的索引号。Long 类型,可读写。
CalculatedMembers返回一个 CalculatedMembers 集合,该集合代表 OLAP 数据透视表的所有计算成员和计算度量值。
CalculatedMembersInFilters返回或设置是否在筛选器中对 OLAP 服务器的计算成员进行求值。可读写。
ChangeList返回 PivotTableChangeList 集合,该集合代表对基于 OLAP 数据源的指定数据透视表所做更改的列表。只读。
ColumnFields返回一个对象,该对象表示单个的数据透视表字段(PivotField 对象)或当前显示为列字段的所有字段的集合(PivotFields 对象)。只读。
ColumnGrand如果数据透视表显示列总计,则该属性值为 TrueBoolean 类型,可读写。
ColumnRange返回一个 Range 对象,该对象代表包含数据透视表中列区域的区域。只读。
CompactLayoutColumnHeader指定透视数据表在压缩行布局表单中时标题中显示的标题。可读写 String
CompactLayoutRowHeader指定透视数据表在压缩行布局表单中时行标题中显示的标题。可读写 String 类型。
CompactRowIndent当启用压缩行布局表单时,返回或设置透视项目的缩进增量。可读写。
Creator返回一个 32 位整数,该整数指示创建对象的应用程序。只读 Long 类型。
CubeFields返回 CubeFields 集合。每个 CubeField 对象包含多维数据集?(多维数据集:一种 OLAP 数据结构。多维数据集包含维度,如“国家/地区/省(或市/自治区)/市(或县)”,还包括数据字段,如“销售额”。维度将各种类型的数据组织到带有明细数据级别的分层结构中,而数据字段度量数量。)字段元素的属性。只读。
DataBodyRange返回一个 Range 对象,该对象代表数据透视表中值的区域。只读。
DataFields返回一个对象,该对象表示单个数据透视表字段(PivotField 对象)或当前显示为数据字段的所有字段集合(PivotFields 对象)。只读。
DataLabelRange返回一个 Range 对象,该对象代表包含数据透视表中数据字段的标签的区域。只读。
DataPivotField返回一个 PivotField 对象,该对象代表数据透视表中的所有数据字段。只读。
DisplayContextTooltips控制是否显示数据透视表单元格的工具提示。可读写 Boolean 类型。
DisplayEmptyColumn如果对数值轴的 OLAP 提供程序的查询中包括非空 MDX 关键字,则返回 True。在结果集中,OLAP 提供程序不返回空列。如果省略非空关键字,则返回 FalseBoolean 类型,可读写。
DisplayEmptyRow如果对分类轴的 OLAP 提供程序的查询中包括非空 MDX 关键字,则返回 True。在结果集中,OLAP 提供程序不返回空行。如果省略非空关键字,则返回 FalseBoolean 类型,可读写。
DisplayErrorString如果数据透视表在有错误的单元格中显示用户自定义的错误字符串,则该值为 True。默认值为 FalseBoolean 类型,可读写。
DisplayFieldCaptions控制是否在网格中显示筛选器按钮以及行和列的透视字段标题。可读/写。
DisplayImmediateItems返回或设置 Boolean,用于指明当数据透视表的数据区域为空时,行和列区域中的项是否可见。如果该属性为 False,则当数据透视表的数据区域为空时,将隐藏行和列区域中的项。默认值为 True
DisplayMemberPropertyTooltips控制是否在工具提示中显示成员属性。可读/写 Boolean 类型。
DisplayNullString如果数据透视表在包含空值的单元格中显示用户自定义的字符串,则该值为 True。默认值为 TrueBoolean 类型,可读写。
EnableDataValueEditing如果为 True,则当用户覆盖数据透视表数据区域中的值时禁用警告。设置为 True 也可以使用户更改先前无法更改的数据值。默认值为 FalseBoolean 类型,可读写。
EnableDrilldown如果启用“显示明细数据”,则该值为 True。默认值为 TrueBoolean 类型,可读写。
EnableFieldDialog如果当用户双击数据透视表字段时,“数据透视表字段”对话框可用,则该属性值为 True。默认值为 TrueBoolean 类型,可读写。
EnableFieldList如果为 False,则禁止显示数据透视表字段列表的功能。如果已经显示字段列表,则该列表将消失。默认值为 TrueBoolean 类型,可读写。
EnableWizard如果“数据透视表向导”可用,则该属性值为 True。默认值为 TrueBoolean 类型,可读写。
EnableWriteback 返回或设置是否为指定数据透视表启用对数据源的回写。默认值为 False。可读写。
ErrorString返回或设置一个 String 值,它代表 DisplayErrorString 属性为 True 时如果单元格中有错误而显示的字符串。
FieldListSortAscending控制数据透视表字段列表中字段的排序顺序。当此属性设置为 True 时,字段按升序顺序排序。当它设置为 False 时,字段按数据源顺序排序。可读/写。
GrandTotalName返回或设置显示在指定数据透视表的总计列或行标题中的文本串标志。默认值为字符串“Grand Total”。String 类型,可读写。
HiddenFields返回一个对象,该对象代表当前未显示为行、列、页或数据字段的单个数据透视表字段(PivotField 对象)或所有字段的集合(PivotFields 对象)。只读。
InGridDropZones此属性用于为 PivotTable 对象切换网格中的拖放区域。在一些情况下,它还会影响数据透视表的布局。可读/写 Boolean 类型。
InnerDetail当最内部行或列字段的 ShowDetail 属性设为 True 时,返回或设置这些详细数据的字段名称。String 类型,可读写。
LayoutRowDefault此属性指定初次将透视字段添加到数据透视表中时它们的布局设置。可读/写 xlLayoutRowType 类型。
Location获取或设置一个 String 类型的值,该值代表指定 PivotTable 主体中左上角的单元格。可读/写。
ManualUpdate如果数据透视表仅在用户请求时重新计算,则该值为 True。默认值为 FalseBoolean 类型,可读写。
MDX返回一个 String 类型的值,该值表示将发送给提供程序以填充当前数据透视表视图的多维表达式 (MDX)。只读。
MergeLabels如果指定的数据透视表的外部行项、列项、分类汇总和总计标志使用合并单元格,则该属性值为 TrueBoolean 类型,可读写。
Name返回或设置一个 String 值,它代表对象的名称。
NullString返回或设置当 DisplayNullStringTrue 时,在包含 null 值的单元格中显示的字符串。默认值为空字符串 ("")。String 类型,可读写。
PageFieldOrder返回或设置页字段在数据透视表布局上的顺序。可为以下 XlOrder 常量之一:xlDownThenOverxlOverThenDown。默认常量是 xlDownThenOverLong 类型,可读写。
PageFields返回一个对象,该对象代表当前显示为页字段的单个数据透视表字段(PivotField 对象)或所有字段的集合(PivotFields 对象)。只读。
PageFieldStyle返回或设置用于边界页字段区域中的样式。默认值为 null 字符串(默认时无样式)。String 类型,可读写。
PageFieldWrapCount返回或设置数据透视表中每行或每列的页字段数目。Long 类型,可读写。
PageRange返回一个 Range 对象,该对象代表包含数据透视表中页区域的区域。只读。
PageRangeCells返回一个 Range 对象,该对象仅代表数据透视表中包含页字段和项目下拉列表的单元格。
Parent返回指定对象的父对象。只读。
PivotColumnAxis返回 PivotAxis 对象,该对象表示整个列轴。只读 PivotAxis 类型。
PivotFormulas返回一个 PivotFormulas 对象,该对象代表指定数据透视表的公式集合。只读。
PivotRowAxis返回 PivotAxis 对象,该对象表示整个行轴。只读 PivotAxis 类型。
PivotSelection以标准数据透视表的选定区域格式返回或设置数据透视表的选定区域。String 类型,可读写。
PivotSelectionStandard返回或设置用英语(美国)设置的标准数据透视表?(数据透视表:一种交互的、交叉制表的 ET 报表,用于对多种来源(包括 ET 的外部数据)的数据(如数据库记录)进行汇总和分析。)格式的数据透视表选定内容的 String 类型的数值。可读写。
PreserveFormatting当使用数据透视、筛选或更改页字段项等操作刷新或重新计算报告时,如果格式处于被保护状态,则为 True。对于查询表,如果数据前五行的任何常规格式设置将应用于查询表数据的新行,则此属性为 True。对未使用的单元格不进行设置。如果将查询表应用的最近一次自动套用格式应用于新数据行,则此属性为 False。默认值是 True
PrintDrillIndicators指定是否随数据透视表打印深化指示符。可读写 Boolean 类型。
PrintTitles如果基于数据透视表设置工作表的打印标题,则该属性值为 True。如果使用工作表的打印标题,则该属性值为 False。默认值为 FalseBoolean 类型,可读写。
RefreshDate返回数据透视表或缓存最近一次刷新的日期。Date 型,只读。
RefreshName返回最近一次刷新数据透视表的人员的名字。String 型,只读。
RepeatItemsOnEachPrintedPage当打印指定的数据透视表时,如果每页第一行上都显示行、列和项标志,则该值为 True。如果仅在第一页上打印这些标志,则该值为 False。默认值为 TrueBoolean 类型,可读写。
RowFields返回一个对象,该对象表示数据透视表中的单个字段(PivotField 对象),或者当前未显示为行字段的所有字段的一个集合(PivotFields 对象)。只读。
RowGrand如果数据透视表显示行的总数,则该属性值为 TrueBoolean 类型,可读写。
RowRange返回一个 Range 对象,该对象代表包含数据透视表中行区域的区域。只读。
SaveData如果数据透视表的数据随工作簿一起保存,则为 True。如果仅保存数据透视表的定义,则为 FalseBoolean 类型,可读写。
SelectionMode返回或设置数据透视表的结构化选择模式。XlPTSelectionMode 类型,可读写。
ShowDrillIndicatorsShowDrillIndicators 属性用于切换数据透视表中深化指示符的显示。可读/写 Boolean 类型。
ShowPageMultipleItemLabel如果为 True(默认),那么只要隐藏了项,并且在数据透视表视图中显示非隐藏项的总计,“( 多个项目 )”将显示在工作表的数据透视表单元格中。Boolean 类型,可读写。
ShowTableStyleColumnHeaders如果列标题应显示在数据透视表中,则将 ShowTableStyleColumnHeaders 属性设置为 True。可读/写 Boolean 类型。
ShowTableStyleColumnStripesShowTableStyleColumnStripes 属性显示镶边列,这些列中的偶数列和奇数列的格式互不相同。这样使数据透视表更易于阅读。可读/写 Boolean 类型。
ShowTableStyleRowHeaders如果行标题应显示在数据透视表中,则将 ShowTableStyleRowHeaders 属性设置为 True。可读/写 Boolean 类型。
ShowTableStyleRowStripesShowTableStyleRowStripes 属性显示镶边行,这些行中的偶数行和奇数行的格式互不相同。这样使数据透视表更易于阅读。可读/写 Boolean 类型。
ShowValuesRow返回或设置是否显示值行。可读写。
Slicers返回指定数据透视表的 Slicers 集合。只读。
SmallGrid如果 ET 为新建的数据透视表使用一个具有两个单元格宽度和两个单元格高度的网格,则该值为 True。如果 ET 使用一个空白模板边框,则该值为 FalseBoolean 类型,可读写。
SortUsingCustomListsSortUsingCustomLists 属性控制最初在初始化透视字段并按 PivotItems 标题对 PivotItems 进行排列时,以及稍后在用户应用排序时,是否将自定义列表用于对字段项进行排序。可读/写 Boolean 类型。
SourceData返回数据透视表的数据源,如下表所示。Variant 型,可读写。
SubtotalHiddenPageItems如果在行或列的分类汇总、块汇总和总计中包括数据透视表中的隐藏页字段项,则该值为 True。默认值为 FalseBoolean 类型,可读写。
Summary返回或设置与指定表的可选文本字符串关联的说明。可读写。
TableRange1返回一个 Range 对象,该对象代表包含整个数据透视表但不包含页字段的区域。只读。
TableRange2返回一个 Range 对象,该对象代表包含整个数据透视表以及页字段的区域。只读。
TableStyle2TableStyle2 属性指定当前应用于数据透视表的数据透视表样式。可读/写。
Tag返回或设置与数据透视表一起保存的字符串。String 类型,可读写。
TotalsAnnotation如果在基于 OLAP 数据源的指定数据透视表中,每个分类汇总和总计旁都显示有星号 (*),则该值为 True。默认值为 TrueBoolean 类型,可读写。
VacatedStyle返回或设置当数据透视表刷新时,应用于空单元格的样式。默认值为无效字符串。(默认状态下没有样式应用)。String 类型,可读写。
Value返回或设置一个 String 值,它代表数据透视表的名称。
Version返回一个 XlPivotTableVersionList 值,该值代表 ET 版本号。
ViewCalculatedMembers如果设置为 True(默认),则可以查看联机分析处理 (OLAP)?(OLAP:为查询和报表(而不是处理事务)而进行了优化的数据库技术。OLAP 数据是按分级结构组织的,它存储在多维数据集而不是表中。) 数据透视表的计算成员。Boolean 类型,可读写。
VisibleFields返回一个对象,该对象表示数据透视表中的单个字段(PivotField 对象),或所有可见字段的一个集合(PivotFields 对象)。可见字段显示为行、列、页或数据字段。只读。
VisualTotals如果该属性值为 True(默认值),则在视图中隐藏项目后,联机分析处理(OLAP)?(OLAP:为查询和报表(而不是处理事务)而进行了优化的数据库技术。OLAP 数据是按分级结构组织的,它存储在多维数据集而不是表中。) 数据透视表将重新汇总。Boolean 类型,可读写。
VisualTotalsForSets返回或设置在指定数据透视表的命名集汇总中是否包括筛选项。可读写。