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