** 译者说明: ** 欢迎访问我的 Blog: http://blog.csdn.net/daidaoke2001/
译文中的错误或不当之处望不吝指出, 这也是我坚持翻译工作的最大动力。
我的 Email : [email protected]
如需转载,请事先通知。
** 编程模型要点 ** ** **
本节中的各表是透视表组件编程模型要点的一个快速参考。当使用透视表控件编写程序时,可以参考本章了解应该使用什么属性,方法和事件。
** 表 ** ** 4 ** ** - ** ** 1 ** ** 。绑定到数据 ** ** **
**_ 属性 _ ** ** **
|
**_ 解释 _ ** ** **
---|---
PivotTable.ConnectionString
|
应将这个属性设置为一个有效的连接字符串,可使透视表控件连接到数据源上。
PivotTable.CommandText
|
将这个属性设置为一个 SQL语句,或任何提供者可接受的命令。该属性仅用于表列数据源。
PivotTable.DataMember
|
将这个属性设置为要使用的 OLAP cube的名称,或是DataSource属性所引用的DSC中的数据集的名称。
PivotTable.DataSource
|
将这个属性设置为 DSC的一个实例,之后就可以将它用作数据源了。即使您使用ConnectionString属性来连接数据源,DataSource属性也会返回一个DSC对象。
** 表 4-2. ** 调整、保存视图布局 。
**_ 属性或方法 _ ** ** **
|
**_ 解释 _ ** ** **
---|---
PivotView.Fieldsets
|
这个属性包含报表中可用的所有有效字段集。
PivotView.Totals
|
这个属性包含报表中可用的所有有效合计值。
InsertFieldset
|
使用这个方法在行轴、列轴或过滤轴上插入一个字段集。
PivotDataAxis.InsertTotal
|
在数据轴上使用这个方法可以将一个合计值插入到报表中。
PivotField.IsIncluded
|
将这个属性设置为 False,可以将一字段集中的一个字段排除出报表。还可以使用这个属性来判断一个字段是否位于报表中。
Expanded
|
将这个属性设置为 True,可以展开一个字段或成员,以显示它的子元素。读取这个属性的值,可以得知一个字段或成员当前是否处于被展开的状态。
PivotView.AutoLayout
|
使用这个方法可以为 OLAP数据源清空视图,或为表列数据源将所有字段放置在细目区域中。
PivotView.AddTotal
|
使用这个方法根据一个细目字段创建一个新的合计值。
PivotField.SortDirection
|
使用这个属性来设置字段排序的方式,或获得字段当前的排序方向。
PivotField.SortOn
|
使用这个属性使字段的各成员根据它们的合计值排序,而不是根据它们的标题。
PivotField.SortOnScope
|
使用这个属性根据一个合计值对一系列成员进行排序,但只针对另一个轴上的一个范围内的成员进行排序(???)
PivotFieldset.FilterMember
|
使用这个属性来读取或设置过滤轴上的一个字段集中当前被选择的成员。
PivotField.FilterMembers
|
使用这个属性获得一个给定字段的当前过滤成员的集合
PivotField.FilterFunction
|
使用这个属性设置或判断 FilterMembers属性所使用的过滤函数。过滤函数可以包含或排除成员,或是没有过滤动作。
PivotTable.XMLData
|
使用这个属性来获得当前报表的定义信息,它是一个巨大的字符串,您可以保存这个字符串,并在将来读取它,并重新设置报表。
PivotView.TotalOrientation
|
使用这个属性来使透视表控件将行标题显示为合计值的标题,而不是列标题。
PivotGroupAxis.DisplayEmptyMembers
|
使用这个属性强迫透视表控件显示完全没有数据的行或列。
** 表 4-3. ** 定制、格式化视图。
**_ 属性 _ ** ** **
|
**_ 解释 _ ** ** **
---|---
PivotTable.AutoFit
|
使用这个属性来关闭 AutoFit特性,在一个基于表单的环境中(例如VB)尤其有用。
PivotView.TitleBar
|
使用这个属性来调整标题条的文字和格式。
PivotTable.DisplayToolbar,
PivotTable.DisplayFieldList,
PivotTable.DisplayPropertyToolbox
|
使用这些属性来控制工具条、字段列表、和属性工具箱这些元素是否可视。
PivotTotal.NumberFormat
|
使用这些属性来格式化合计值的数字。
PivotField.SubtotalBackColor
|
使用这个属性来设置小计的背景色,使得小计和那些组成小计的数字显得不同。当一个大报表中需要在视觉上区别不同级别的合计值时, SubtotalBackColor属性十分有用。
PivotField.SubtotalFont
|
利用这个属性,可以使小计的字体和组成小计的数字的字体不同。
PivotTable.MemberExpand
|
使用这个属性使透视表控件在将字段和成员添加到视图中自动展开它们。
** 表 4-4. ** 重要的事件。
** 事件 **
|
**_ 解释 _ ** ** **
---|---
QueryComplete
|
当透视表控件在数据源上执行了一个查询后触发该事件,通常发生该事件时应该改变报表的布局。这是一个调整报表标题,以及任何其它需要和报表同步的用户界面元素的好机会。
Click
|
当用户在报表上点击时触发。请使用 Selection属性来判断用户点击了哪里。
DblClick
|
和 Click事件相似,但是是在用户双击时触发。常用来触发一个跳转,转到另一页以显示组成一个汇总值的细目信息,也可用来显示属性工具箱,或显示您自定义格式的用户界面。
SelectionChange
|
当报表中被选择的部分改变时触发。主要用于当选择了新的数值时,需要改变页面或窗体上的其它元素的情况。
PivotTableChange
|
在使用表列数据源时,会有多种原因触发该事件。事件的参数 Reason说明了触发事件的原因,比如说,创建了一个新的汇总值,或删除了一个汇总值。
ViewChange
|
该事件会被频繁的触发,因此不应在该事件处理函数中处理太多的任务。视图中任何一点轻微的改动都可能触发该事件;事件参数 Reason说明了具体发生了什么。请参考OWC联机帮助文件(Msowcvba.chm)中的枚举PivotViewReasonEnum,它包含了触发该事件的各种原因的完整列表。
** 小 ** ** ** ** 结 ** ** **
本章包括了关于透视表组件的,许多开发者的常见问题的解答,因此阅读完本章后,您应该已经比较了解这项强大技术的各项功能了。下面在第七章中将讲述更多透视表组件的内容,在该章中将研究一个完整的 OLAP 销售分析和报表系统的源码。
附录:英文原文
** Key Elements of the Programming Model **
The tables in this section provide a quick synopsis of the key elements in the PivotTable component's programming model. When you sit down to write a new program using the PivotTable control, refer to this section for a reminder of what properties, methods, and events to use.
** Table 4-1. ** Binding to data.
**_ Property _ ** ** **
|
**_ Description _ ** ** **
---|---
PivotTable.ConnectionString
|
Set this to a valid connection string to hook up the PivotTable control to the data source.
PivotTable.CommandText
|
Set this to a SQL statement or whatever command text the provider will accept. CommandText is used only for tabular data sources.
PivotTable.DataMember
|
Set this to the name of the OLAP cube you want to use or the name of the data set in the DSC referred to by the DataSource property.
PivotTable.DataSource
|
Set this to an instance of the DSC to use it as the data source. DataSource also will return the DSC even when you use the built-in ConnectionString property.
** Table 4-2. ** Adjusting and saving the view layout.
**_ Property or Method _ ** ** **
|
**_ Description _ ** ** **
---|---
PivotView.Fieldsets
<TD style="BORDER-RIGHT: #d4d0c8; PADDING-RIGHT: 3.75pt; BORDER-TOP: #d4d0c8; PADDING-LEFT: 3.75pt; PADDING-BOTTOM: 3.75pt; BORDER-LEFT: #d4d0c8; PADDING-TOP: 3.75