このセクションは、 xamPivotGrid コントロールのイベントの処理に関するタスク ベースの手順についての役立つ情報を提供します。
このトピックは以下のように構成されています。
まず始めに、xamPivotGrid コントロールとそれがサポートするデータ ソースを理解するために xamPivotGrid を使用した作業の開始および データのバインディングトピックスを読んでください。
xamPivotGrid コントロールでは、イベントはそれを発生させるオブジェクトに応じて 2 つのグループにカテゴリ分けされます。
表 1 - xamPivotGrid のイベント グループ
xamPivotGrid コントロールは多くのイベントをもち、イベントの完全なリストは xamPivotGrid の APIの概要のイベント セクションにあります。以下は、よく使われるイベントを説明しています。
表 2 - xamPivotGrid コントロールによって公開されるイベント
*このイベントは、 XamPivotDataSelector クラスでも使用できます。
以下のコード例は、CellControlAttached イベントの処理によってセルがロードされる時に列番号 2 (null でない場合) のセルにスタイルを適用します。
Visual Basic の場合:
Imports Infragistics.Controls.Grids
...
AddHandler Me.PivotGrid.DataSource.CellControlAttached, AddressOf OnPivotGridCellControlAttached
...
Private Sub OnPivotGridCellControlAttached( ByVal sender As Object, ByVal e As PivotCellControlAttachedEventArgs)
If Me.PivotGrid.DataColumns.IndexOf(e.Cell.DataColumn) = 1 Then
e.Cell.Style = TryCast(Me.Resources("FormattedCellStyle"), System.Windows.Style)
End If
End Sub
C# の場合:
using Infragistics.Controls.Grids;
...
this.PivotGrid.CellControlAttached += OnPivotGridCellControlAttached;
...
void OnPivotGridCellControlAttached(object sender, PivotCellControlAttachedEventArgs e)
{
if (this.PivotGrid.DataColumns.IndexOf(e.Cell.DataColumn) == 1)
{
e.Cell.Style = this.Resources["FormattedCellStyle"] as System.Windows.Style;
}
}
これらのイベントが発生する時にカスタム ロジックを実装することに加えて、これらのイベントを使用して機能の一部を無効にすることもできます。以下のコード例は、ヘッダーの拡張を無効にし、2 番目の列の列のリサイズをキャンセルし、列が並べ替えられた時にメッセージを表示します。
Visual Basic の場合:
Imports Infragistics.Controls.Grids
...
AddHandler Me.PivotGrid.AxisExpansionChanging, AddressOf OnPivotGridAxisExpansionChanging
AddHandler Me.PivotGrid.ColumnResizing, AddressOf OnPivotGridColumnResizing
AddHandler Me.PpivotGrid.ColumnSorted, AddressOf OnPivotGridColumnSorted
...
Private Sub AxisExpansionChanging(ByVal sender As Object, ByVal e As CancellableAxisEventArgs)
e.Cancel = True
End Sub
Private Sub ColumnResizing(ByVal sender As Object, ByVal e As CancellableColumnResizingEventArgs)
If e.Columns.Contains(Me.pivotGrid.DataColumns(1)) Then
e.Cancel = True
End If
End Sub
Private Sub ColumnSorted(ByVal sender As Object, ByVal e As PivotSortedColumnEventArgs)
MessageBox.Show(e.Column.Key + " was sorted.")
End Sub
C# の場合:
using Infragistics.Controls.Grids;
...
this.PivotGrid.AxisExpansionChanging += OnPivotGridAxisExpansionChanging;
this.PivotGrid.ColumnResizing += OnPivotGridColumnResizing;
this.PivotGrid.ColumnSorted += OnPivotGridColumnSorted;
...
void OnPivotGridColumnResizing(object sender, PivotCancellableColumnResizingEventArgs e)
{
if (e.Columns.Contains(this.pivotGrid.DataColumns[1]))
{
e.Cancel = true;
}
}
void OnPivotGridColumnSorted(object sender, PivotSortedColumnEventArgs e)
{
System.Windows.MessageBox.Show(e.Column.Key + " was sorted.");
}
void OnPivotGridAxisExpansionChanging(object sender, PivotCancellableAxisEventArgs e)
{
e.Cancel = true;
}
xamPivotGrid コントロールの DataSource は IOlapViewModel インターフェイスのわずかな、いずれもデータのローディングに関係するイベントだけを公開します。完全なリストについては、API リファレンス ガイドの Infragistics.WPF.Olap NuGet パッケージ セクションの IOlapViewModel インターフェイスを参照してください。
表 3 - IOlapViewModel インターフェイスによって公開されるイベント
ロード イベントは、DataSource がディメンション、メジャー、キューブまたはメンバー、データ ロードのプログレス インジケーターの初期化、ならびに他のアプリケーション中の異なるキューブに基づいたスタイリングを完了した時を知りたい場合に役立ちます。
以下のコードは、キューブがロードされ、結果が変更されるたびにメッセージを表示する時にスタイルを適用する方法を示します。
Visual Basic の場合:
Imports Infragistics.Controls.Grids
...
AddHandler Me.pivotGrid.DataSource.LoadCubesCompleted, AddressOf OnDataSourceLoadCubesCompleted
AddHandler Me.pivotGrid.DataSource.ResultChanged, AddressOf OnDataSourceResultChanged
...
Private Sub OnDataSourceLoadCubesCompleted(ByVal sender As Object, ByVal e As LoadCubesCompletedEventArgs)
Me.pivotGrid.Style = Me.Resources("PivotGridStyle")
End Sub
Private Sub OnDataSourceResultChanged(ByVal sender As Object, ByVal e As AsyncCompletedEventArgs)
System.Windows.MessageBox.Show("The result is changed!")
End Sub
C# の場合:
using Infragistics.Controls.Grids;
...
this.PivotGrid.DataSource.LoadCubesCompleted += OnDataSourceLoadCubesCompleted;
this.PivotGrid.DataSource.ResultChanged += OnDataSourceResultChanged;
...
void OnDataSourceResultChanged(object sender, System.ComponentModel.AsyncCompletedEventArgs e)
{
System.Windows.MessageBox.Show("The result is changed!");
}
void OnDataSourceLoadCubesCompleted(object sender, LoadCubesCompletedEventArgs e)
{
this.PivotGrid.Style = this.Resources["PivotGridStyle"] as System.Windows.Style;
}