カスタム レポート アイテム クラス ライブラリ

カスタム レポート アイテムは、Microsoft.ReportDesigner 名前空間のクラスを使用します。 カスタム レポート アイテムを実装する際に使用するクラスは、2 つの主なカテゴリに分類できます。1 つは、カスタム レポート アイテム インフラストラクチャをサポートするためにデザインされた独自のクラス、もう 1 つは、関連するレポート定義言語 (RDL) 要素の機能をカプセル化するマネージド ラッパー クラスです。 これらのクラスの使用方法のコード サンプルについては、「SQL Server Reporting Services Product Samples」 (SQL Server Reporting Services の製品サンプル) を参照してください。

カスタム レポート アイテム インフラストラクチャ クラス

以下のクラスは、カスタム レポート アイテムを実装するために使用されます。

Note

以下の各表はすべてを網羅したものではなく、各クラスの最も一般的に使用されるプロパティやメソッドのみが含まれています。

Microsoft.ReportDesigner.CustomReportItemDesigner

Microsoft.ReportDesigner.CustomReportItemDesigner は、カスタム レポート アイテム クラスメインです。 カスタム レポート アイテムの実装のメイン クラスは、このクラスを継承する必要があります。

パブリック プロパティ

プロパティ	内容
名前	カスタム レポート アイテムの名前
Type	カスタム レポート アイテムの種類。
CustomData	デザイン時に指定されたカスタム レポート アイテムのデータ プロパティをカプセル化する CustomData オブジェクト
CustomProperties	カスタム レポート アイテムのカスタム プロパティのコレクション
Height	カスタム レポート アイテム コントロールの高さ
Width	カスタム レポート アイテム コントロールの幅
Report	レポート レベルのプロパティ (レポートのデータセットの一覧など) のコンテナー
AltReportItem	カスタム レポート アイテムの実行時コントロールがサポートされていない場合に使用される代替レポート アイテム オブジェクト。
スタイル	カスタム レポート アイテムのスタイルのプロパティ
Adornment	コントロールのインタラクティブな編集のために使用される装飾ウィンドウ
サイト	コンポーネントの ISite
DesignerVerbCollection	コントロールのショートカット メニューのカスタム動詞の配列

パブリック メソッド

メソッド	説明
BeginEdit	コントロールのインタラクティブな編集をアクティブにします。
DoDefaultAction	コントロールをダブルクリックしたとき、またはコントロールに対して Enter キーを押したときに呼び出されます。
EndEdit	コントロールのインタラクティブな編集を非アクティブにします。
GetService	サービスを表すオブジェクトを返します。
InitializeNewComponent	新しいカスタム レポート アイテムの作成時に呼び出されます。
Invalidate	コントロールの表面全体を再描画します。
OnDragEnter OnDragDrop	オブジェクトをコントロールにドラッグすると呼び出されます。
OnPaint	Paint イベントに応答して呼び出されます。

Microsoft.ReportDesigner.CustomReportItemAttribute

Microsoft.ReportDesigner.CustomReportItemAttribute は、カスタム レポート アイテムの種類を識別するために使用される属性です。 この名前は、レポート デザイナー構成ファイルの ReportItem 要素の <名前> 属性の値と一致している必要があります。

パブリック メソッド

メソッド	説明
CustomReportItemAttribute	CustomReportItemAttribute オブジェクトを構築します。

Microsoft.ReportDesigner.LocalizedNameAttribute

Microsoft.ReportDesigner.LocalizedNameAttribute は、カスタム レポート アイテム デザイナーに使用する表示名を指定するために使用される属性です。

パブリック メソッド

メソッド	説明
LocalizedNameAttribute	LocalizedNameAttribute オブジェクトを構築します。

Microsoft.ReportDesigner.Adornment

Adornment クラスは、カスタム レポート アイテムのデザイン時コンポーネントによって、デザイン画面のメインの四角形の外に領域を作成するために使用されます。 これらの領域では、マウス クリックやドラッグ アンド ドロップ操作などのユーザー インターフェイス イベントを扱うことができます。

パブリック メソッド

メソッド	説明
OnShow	Adornment がアクティブになると呼び出されます。
OnHide	Adornment が非アクティブになると呼び出されます。
ペイント	Paint イベントに応答して呼び出されます。
OnDragEnter OnDragOver OnDragLeave OnDragDrop	オブジェクトを Adornment にドラッグすると呼び出されます。

Microsoft.ReportDesigner.AdornerService

このクラスは、カスタム レポート アイテムのデザイン時コンポーネントの Adornment オブジェクトをサポートするためにカスタム レポート アイテムによって使用される、表示サービスのコレクションを提供するために使用されます。

パブリック プロパティ

プロパティ	説明
AdornerWindowBounds	Adorner ウィンドウの境界
AdornerWindowRegion	Adorner ウィンドウの領域
AdornerWindowGraphics	Adorner ウィンドウのグラフィック コンテキスト

パブリック メソッド

メソッド	説明
ComponentRectInDesignerFrame	デザイナー フレームの座標に変換されたコンポーネントの境界を返します。
InvalidateAdorner	Adorner ウィンドウを無効にします。
PointToAdorner	Adorner ウィンドウの座標に変換された画面座標の点を返します。

Microsoft.ReportDesigner.ExpressionEditor

このクラスは、カスタム レポート アイテムのデザイン時コントロールから式エディターを呼び出すために使用できます。

パブリック メソッド

メソッド	説明
EditValue	式エディターを呼び出して、渡されたオブジェクト値で初期化します。

Microsoft.ReportDesigner.IFieldsDataObject

このクラスは Reporting Services フィールドのコレクションであり、デザイン環境でドラッグ アンド ドロップ イベントをサポートするために使用されます。 IReportItemDataObject から継承します。

パブリック プロパティ

プロパティ	説明
DataSetName	ドロップされるフィールドを含むデータセットの名前
Fields	削除されるフィールドのコレクション (Microsoft.ReportDesigner.Field)

関連するコンテンツ

レポート定義言語 (SSRS)
カスタム レポート アイテムの実行時コンポーネントの作成
カスタム レポート アイテムのデザイン時コンポーネントの作成