CellExporting イベント

グリッドのセルがレポートにエクスポートされる前に発生

シンタックス

Visual Basic

'宣言
 
Public Event CellExporting As EventHandler(Of CellExportingEventArgs)

C#

public event EventHandler<CellExportingEventArgs> CellExporting

イベント データ

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

プロパティ	解説
Cancel System.ComponentModel.CancelEventArgsから継承されます。
CellValue	グリッド セル値を返します。
ExportValue	レポートにエクスポートされる値を取得または設定します。
GridColumn	エクスポートされているセルを含む Infragistics.Win.UltraWinGrid.UltraGridColumn を返します。
GridRow	セルを含む Infragistics.Win.UltraWinGrid.UltraGridRow を返します。
ReportCell	セルのコンテンツがエクスポートされる Infragistics.Documents.Reports.Report.Grid.IGridCell を返します。

解説

CellExportingEventArgs.GridRow はセルを含む Infragistics.Win.UltraWinGrid.UltraGridRow を返します。

CellExportingEventArgs.GridColumn は関連付けられた Infragistics.Win.UltraWinGrid.UltraGridColumn を返します。

CellExportingEventArgs.ReportCell はセルのコンテンツがエクスポートされる Infragistics.Documents.Reports.Report.Grid.IGridCell を返します。

このイベントはデータ セルのみに対して発生します。ヘッダーまたは集計セルに対しては発生しません。ヘッダー セルには HeaderCellExporting を使用します。集計セルには、SummaryCellExporting を使用します。

Cancel 引数を使用して、セルのエクスポートをキャンセルします。

これらのイベント引数を使用して、セルのエクスポートをオーバーライドし、カスタム エクスポートを提供することが可能です。通常、これは Cancel を True に設定し、コンテンツを ReportCell に追加することで行われます。

使用例

Visual Basic

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

Private Sub ultraGridDocumentExporter1_CellExporting(ByVal sender As System.Object, ByVal e As Infragistics.Win.UltraWinGrid.DocumentExport.CellExportingEventArgs) Handles ultraGridDocumentExporter1.CellExporting
	' Check to see if this is the 'Int32 1' columns. 
	If (e.GridColumn.Key = "Int32 1") Then

		' Instead of exporting the value, just export a string indicating negative, 
		' zero, or positive. 

		' Get the value of the cell as an integer
		Dim cellValueAsInteger As Integer = CType(e.CellValue, Integer)

		' Change the ExportValue. This will not effect the on-screen grid or the 
		' underyling data, only the report. 
		Select Case cellValueAsInteger
			Case Is < 0
			e.ExportValue = "Negative"
				Case 0
			e.ExportValue = "Zero"
				Case Else
			e.ExportValue = "Positive"
		End Select
	End If
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_CellExporting(object sender, CellExportingEventArgs e)
{
	// Check to see if this is the 'Int32 1' columns. 
	if (e.GridColumn.Key == "Int32 1")
	{
		// Instead of exporting the value, just export a string indicating negative, 
		// zero, or positive. 

		// Get the value of the cell as an integer
		int cellValueAsInteger = (int)e.CellValue;

		// Change the ExportValue. This will not effect the on-screen grid or the 
		// underyling data, only the report. 
		if (cellValueAsInteger < 0)
			e.ExportValue = "Negative";
		else if (cellValueAsInteger == 0)
			e.ExportValue = "Zero";
		else
			e.ExportValue = "Positive";
	}
}