C++ 应用集成 WPS 指南 > 表格 API 参考 > PivotTable > PivotTable 对象成员

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

方法

? 名称 说明
AddDataField 将数据字段添加到数据透视表中。返回一个 PivotField 对象,该对象表示新的数据字段。
AddFields 向数据透视表或数据透视图中添加行字段、列字段和页字段。
AllocateChanges 在基于 OLAP 数据源的数据透视表中的所有已编辑的单元格上执行回写操作。
CalculatedFields 返回一个 CalculatedFields 集合,该集合代表指定数据透视表中的所有计算字段。只读。
ChangeConnection 更改指定 PivotTable 的连接。
ChangePivotCache 更改指定 PivotTablePivotCache
ClearAllFilters ClearAllFilters 方法将删除当前应用于数据透视表的所有筛选。包括删除 PivotTable 对象的 PivotFilters 集合中的所有筛选,删除应用的所有手动筛选以及将报表筛选区域中的所有筛选字段设置为默认项。
ClearTable ClearTable 方法用于清除数据透视表。清除数据透视表包括删除所有字段以及删除应用于数据透视表的所有筛选和排序。此方法将数据透视表重置为该表刚创建而尚未添加任何字段时的状态。
CommitChanges 在基于 OLAP 数据源的数据透视表的数据源上执行提交操作。
ConvertToFormulas ConvertToFormulas 方法是 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 类型,可读写。
ShowDrillIndicators ShowDrillIndicators 属性用于切换数据透视表中深化指示符的显示。可读/写 Boolean 类型。
ShowPageMultipleItemLabel 如果为 True(默认),那么只要隐藏了项,并且在数据透视表视图中显示非隐藏项的总计,“( 多个项目 )”将显示在工作表的数据透视表单元格中。Boolean 类型,可读写。
ShowTableStyleColumnHeaders 如果列标题应显示在数据透视表中,则将 ShowTableStyleColumnHeaders 属性设置为 True。可读/写 Boolean 类型。
ShowTableStyleColumnStripes ShowTableStyleColumnStripes 属性显示镶边列,这些列中的偶数列和奇数列的格式互不相同。这样使数据透视表更易于阅读。可读/写 Boolean 类型。
ShowTableStyleRowHeaders 如果行标题应显示在数据透视表中,则将 ShowTableStyleRowHeaders 属性设置为 True。可读/写 Boolean 类型。
ShowTableStyleRowStripes ShowTableStyleRowStripes 属性显示镶边行,这些行中的偶数行和奇数行的格式互不相同。这样使数据透视表更易于阅读。可读/写 Boolean 类型。
ShowValuesRow 返回或设置是否显示值行。可读写。
Slicers 返回指定数据透视表的 Slicers 集合。只读。
SmallGrid 如果 ET 为新建的数据透视表使用一个具有两个单元格宽度和两个单元格高度的网格,则该值为 True。如果 ET 使用一个空白模板边框,则该值为 FalseBoolean 类型,可读写。
SortUsingCustomLists SortUsingCustomLists 属性控制最初在初始化透视字段并按 PivotItems 标题对 PivotItems 进行排列时,以及稍后在用户应用排序时,是否将自定义列表用于对字段项进行排序。可读/写 Boolean 类型。
SourceData 返回数据透视表的数据源,如下表所示。Variant 型,可读写。
SubtotalHiddenPageItems 如果在行或列的分类汇总、块汇总和总计中包括数据透视表中的隐藏页字段项,则该值为 True。默认值为 FalseBoolean 类型,可读写。
Summary 返回或设置与指定表的可选文本字符串关联的说明。可读写。
TableRange1 返回一个 Range 对象,该对象代表包含整个数据透视表但不包含页字段的区域。只读。
TableRange2 返回一个 Range 对象,该对象代表包含整个数据透视表以及页字段的区域。只读。
TableStyle2 TableStyle2 属性指定当前应用于数据透视表的数据透视表样式。可读/写。
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 返回或设置在指定数据透视表的命名集汇总中是否包括筛选项。可读写。