BeginExport イベント

エクスポートが始まる前に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event BeginExport As EventHandler(Of BeginExportEventArgs)

C#

public event EventHandler<BeginExportEventArgs> BeginExport

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、BeginExportEventArgs 型の引数を受け取りました。次の BeginExportEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
Layout	エクスポートされるグリッドのクローン Infragistics.Win.UltraWinGrid.UltraGridLayout。
Rows	エクスポートされるグリッドのルート Infragistics.Win.UltraWinGrid.RowsCollection。
Section	グリッドがエクスポートされるレポートの Infragistics.Documents.Reports.Report.Section.ISection。

解説

BeginExportEventArgs.Layout はエクスポートされるグリッドのクローン Infragistics.Win.UltraWinGrid.UltraGridLayout です。レイアウトはクローンであるので、オンスクリーン グリッドに影響を与えずにエクスポートするためのレイアウトを安全に変更できます。

BeginExportEventArgs.Rows はエクスポートされるグリッドのルート Infragistics.Win.UltraWinGrid.RowsCollection です。

BeginExportEventArgs.Section はグリッドがエクスポートされるレポートの Infragistics.Documents.Reports.Report.Section.ISection です。セクション PageSize は、エクスポート プロセス中に自動的に設定され、このイベントで変更すべきではありません。

このイベントは、Export(UltraGrid,String,GridExportFileFormat) メソッドが呼び出される時にすべての他のイベントの前に発生されます。このイベントを使用すれば、エクスポートプロセスが始まる前の前処理を行うことができます。たとえば、クローン レイアウトにプロパティを設定できます。

使用例

Visual Basic

Imports Infragistics.Documents.Report
Imports Infragistics.Win.UltraWinGrid.DocumentExport
Imports Infragistics.Documents.Report.Section
Imports Infragistics.Documents.Report.Text

Private Sub ultraGridDocumentExporter1_BeginExport(ByVal sender As System.Object, ByVal e As Infragistics.Win.UltraWinGrid.DocumentExport.BeginExportEventArgs) Handles ultraGridDocumentExporter1.BeginExport

	' Insert some content into the report before the grid.
	Dim text As IText = e.Section.AddText()
	text.AddContent("This is some extra text inserted into the report before the grid in the same section.")

End Sub

C#

using Infragistics.Documents.Report;
using Infragistics.Win.UltraWinGrid.DocumentExport;
using Infragistics.Documents.Report.Section;
using Infragistics.Documents.Report.Text;

private void ultraGridDocumentExporter1_BeginExport(object sender, BeginExportEventArgs e)
{
	// Insert some content into the report before the grid.
	IText text = e.Section.AddText();
	text.AddContent("This is some extra text inserted into the report before the grid in the same section.");
}