自訂報表項目類別庫

自訂報表項目使用來自 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)。

相關內容

報表定義語言 (SSRS)
建立自訂報表專案運行時間元件
建立自訂報表項目設計時間元件