自定义报表项类库
自定义报表项使用 Microsoft.ReportDesigner 命名空间中的类。用于实现自定义报表项的类可分为两个主要类别:用于支持自定义报表项基础结构的唯一类和用于封装相关报表定义语言 (RDL) 元素功能的托管包装类。有关如何使用这些类的代码示例的详细信息,请参阅 SQL Server Reporting Services Product Samples(SQL Server Reporting Services 产品示例)。
自定义报表项基础结构类
以下类用于实现自定义报表项。
注意 |
---|
以下表并非完整列表;这些表仅包括每个类最常用的属性和方法。 |
Microsoft.ReportDesigner.CustomReportItemDesigner
这是自定义报表项主类。自定义报表项实现的主类必须继承自此类。
公共属性
Name |
自定义报表项的名称。 |
Type |
自定义报表项的类型。 |
CustomData |
用于封装在设计时指定的自定义报表项数据属性的 Microsoft.ReportingServices.ReportRendering.CustomReportItem.CustomData 类。 |
CustomProperties |
自定义报表项的自定义属性的集合。 |
Height |
自定义报表项控件的高度。 |
Width |
自定义报表项控件的宽度。 |
Report |
报表级别属性(如报表中数据集的列表)的容器。 |
AltReportItem |
备用报表项对象,可在不支持自定义报表项运行时控件时使用。 |
Style |
自定义报表项的样式属性。 |
Adornment |
用于对控件进行交互式编辑的装饰窗口。 |
Site |
component 的 ISite。 |
DesignerVerbCollection |
控件快捷菜单的一组自定义谓词。 |
公共方法
BeginEdit |
激活控件的交互式编辑。 |
DoDefaultAction |
在响应对控件的双击或在控件上按 Return 键时调用。 |
EndEdit |
停用控件的交互式编辑。 |
GetService |
返回一个表示服务的对象。 |
InitializeNewComponent |
当创建新的自定义报表项时调用。 |
Invalidate |
重新绘制控件的整个图面。 |
OnDragEnter OnDragDrop |
当将对象拖到控件上时调用。 |
OnPaint |
当响应 Paint 事件时调用。 |
Microsoft.ReportDesigner.CustomReportItemAttribute
这是用于标识自定义报表项的类型的属性。此名称必须与报表设计器配置文件中 ReportItem 元素的 <Name> 属性的值相匹配。
公共方法
CustomReportItemAttribute |
构造 CustomReportItemAttribute 对象。 |
Microsoft.ReportDesigner.LocalizedNameAttribute
这是用于指定自定义报表项设计器所使用的显示名称的属性。
公共方法
LocalizedNameAttribute |
构造 LocalizedNameAttribute 对象。 |
Microsoft.ReportDesigner.Adornment
自定义报表项设计时组件使用 Adornment 类来提供设计图面主矩形之外的区域。这些区域可用来处理用户界面事件,如鼠标单击和拖放操作。
公共方法
OnShow |
当激活 Adornment 时调用。 |
OnHide |
当停用 Adornment 时调用。 |
Paint |
当响应 Paint 事件时调用。 |
OnDragEnter OnDragOver OnDragLeave OnDragDrop |
当将对象拖入 Adornment 时调用。 |
Microsoft.ReportDesigner.AdornerService
此类用于提供自定义报表项所使用的一组显示服务,以支持自定义报表项设计时组件中的 Adornment 对象。
公共属性
AdornerWindowBounds |
装饰器窗口的界限。 |
AdornerWindowRegion |
装饰器窗口的区域。 |
AdornerWindowGraphics |
装饰器窗口的图形上下文。 |
公共方法
ComponentRectInDesignerFrame |
返回转换为设计器框架坐标的组件的边界。 |
InvalidateAdorner |
使装饰器窗口失效。 |
PointToAdorner |
返回转换为装饰器窗口坐标的屏幕坐标中的点。 |
Microsoft.ReportDesigner.ExpressionEditor
可以从自定义报表项设计时控件使用此类调用表达式编辑器。
公共方法
EditValue |
调用以给定的对象值初始化的表达式编辑器。 |
Microsoft.ReportDesigner.IFieldsDataObject
此类是 Reporting Services 字段的集合,用于支持设计环境中的拖放事件。此类继承自 IReportItemDataObject。
公共属性
DataSetName |
包含要拖放的字段的数据集的名称。 |
Fields |
要拖放的字段 (Microsoft.ReportDesigner.Field) 的集合。 |