カスタム レポート アイテム クラス ライブラリ
カスタム レポート アイテムは、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) |