自訂報表項目類別庫
自訂報表項目使用來自 Microsoft.ReportDesigner 命名空間的類別。 用於實作自訂報表項目的類別可以分成兩個主要類別：設計為支援自訂報表項目基礎結構的唯一類別，以及封裝相關報表定義語言 (RDL) 元素之功能的 Managed 包裝函數類別。 如需如何使用這些類別的程式碼範例，請參閱 SQL Server Reporting Services 產品範例。
自訂報表項目基礎結構類別
下列類別可用於實作自訂報表項目。
注意
下表並非完整的清單，其中僅包含每個類別最常用的屬性和方法。
Microsoft.ReportDesigner.CustomReportItemDesigner
Microsoft.ReportDesigner.CustomReportItemDesigner 是主要的自定義報表項目類別。 自訂報表項目實作的主要類別必須繼承自這個類別。
公用屬性
| 屬性 | 描述 |
|---|---|
| 名稱 | 自訂報表項目的名稱。 |
| 類型 | 自訂報表項目的類型。 |
| CustomData | CustomData 物件，用來封裝在設計階段所指定的自訂報表項目資料屬性。 |
| CustomProperties | 自訂報表項目的自訂屬性集合。 |
| 高度 | 自訂報表項目控制項的高度。 |
| 寬度 | 自訂報表項目控制項的寬度。 |
| Report | 報表層級屬性的容器，例如報表中資料集的清單。 |
| AltReportItem | 替代報表項目物件，用於不支援自定義報表專案運行時間控件的位置。 |
| Style | 自訂報表項目的樣式屬性。 |
| 裝飾 | 用於控制項互動式編輯的裝飾視窗。 |
| 站台 | 元件的 ISite。 |
| DesignerVerbCollection | 控制項捷徑功能表的自訂動詞命令陣列。 |
公用方法
| 方法 | Description |
|---|---|
| BeginEdit | 啟動控制項的互動式編輯。 |
| DoDefaultAction | 在回應按兩下控制項或在控制項上按 Return 鍵時呼叫。 |
| EndEdit | 停用控制項的互動式編輯。 |
| GetService | 傳回 物件，表示服務。 |
| InitializeNewComponent | 在建立新的自訂報表項目時呼叫。 |
| Invalidate | 重新繪製控制項的整個介面。 |
| OnDragEnter OnDragDrop |
在物件拖曳到控制項上時呼叫。 |
| OnPaint | 在回應 Paint 事件時呼叫。 |
Microsoft.ReportDesigner.CustomReportItemAttribute
Microsoft.ReportDesigner.CustomReportItemAttribute 是用來識別自定義報表項目類型的屬性。 該名稱必須符合報表設計師組態檔中 ReportItem 項目的 <名稱> 屬性值。
公用方法
| 方法 | Description |
|---|---|
| CustomReportItemAttribute | 建構 CustomReportItemAttribute 物件。 |
Microsoft.ReportDesigner.LocalizedNameAttribute
Microsoft.ReportDesigner.LocalizedNameAttribute 是用來指定用於自定義報表項目設計工具之顯示名稱的屬性。
公用方法
| 方法 | Description |
|---|---|
| LocalizedNameAttribute | 建構 LocalizedNameAttribute 物件。 |
Microsoft.ReportDesigner.Adornment
Adornment 類別會由自訂報表項目設計階段元件用於在設計介面主要矩形之外提供區域。 這些區域可以處理使用者介面事件，例如按一下滑鼠和拖放作業等。
公用方法
| 方法 | Description |
|---|---|
| OnShow | 在啟動 Adornment 時呼叫。 |
| OnHide | 在停用 Adornment 時呼叫。 |
| 小畫家 | 在回應 Paint 事件時呼叫。 |
| OnDragEnter OnDragOver OnDragLeave OnDragDrop |
在物件拖曳到 Adornment 內時呼叫。 |
Microsoft.ReportDesigner.AdornerService
這個類別會用於提供顯示服務的集合，自訂報表項目使用此集合來支援自訂報表項目設計階段元件的 Adornment 物件。
公用屬性
| 屬性 | Description |
|---|---|
| AdornerWindowBounds | 裝飾項視窗的界限。 |
| AdornerWindowRegion | 裝飾項視窗的區域。 |
| AdornerWindowGraphics | 裝飾項視窗的圖形內容。 |
公用方法
| 方法 | Description |
|---|---|
| ComponentRectInDesignerFrame | 傳回翻譯成設計工具框架 (Frame) 座標的元件界限。 |
| InvalidateAdorner | 停用裝飾項視窗。 |
| PointToAdorner | 傳回翻譯成裝飾項視窗座標的點螢幕座標 (Screen Coordinate)。 |
Microsoft.ReportDesigner.ExpressionEditor
這個類別可從自訂報表項目設計階段控制項用於叫用運算式編輯器。
公用方法
| 方法 | Description |
|---|---|
| EditValue | 叫用運算式編輯器 (以給定的物件值初始化)。 |
Microsoft.ReportDesigner.IFieldsDataObject
這個類別是 Reporting Services 欄位的集合，可用於支援設計環境中的拖放事件。 繼承自 IReportItemDataObject。
公用屬性
| 屬性 | Description |
|---|---|
| DataSetName | 包含要卸除之欄位的資料集名稱。 |
| 欄位 | 要卸除的欄位集合 (Microsoft.ReportDesigner.Field)。 |