列集計イベント (igGrid)

トピックの概要

目的

このトピックは、igGrid™ の列集計ウィジェットに固有のイベントを説明します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

• イベントの概要
• jQuery および MVC でハンドラーをイベントに添付する
• イベント参照チャート
• 関連トピック

イベントの概要

列集計ウィジェットに固有なイベントは 3 つあります。(以下の「イベント参照チャート」ブロックを参照してください)。サフィックスが「-ing」のすべてのイベントはキャンセルでき、ハンドラーによって false を戻す場合に伝達を終了できます。

JavaScript の場合:

$("#grid1").igGrid({
   features: [
    {
        name: 'Summaries',
        showDropDownButton: true,
        summariesCalculating: function (e, args) {
              return  false;
        }
     }
   ]
});

引数のメソッドおよびプロパティのほとんどに、それらが属するグリッドだけでなく、行固有のデータが含まれています。

jQuery および MVC でハンドラーをイベントに添付する

イベントに添付するには、プロパティの定義と同じようにイベントのハンドラーを定義する必要があります。これでイベントをトリガーすると、ハンドラーが呼び出されます。

JavaScript の場合:

$("#grid1").igGrid({
    features: [
        {
            name: 'Summaries',
            showDropDownButton: true,
            summariesCalculating: function (e, args) {
            // Handle event  
            }
        }
    ]
});

MVC でハンドラーを添付する場合、jQuery UI パターンを使用する必要があります。このパターンは、コントロールとイベントの名前を小文字で連結したものです。

JavaScript の場合:

$("#grid1").live("iggridsummariessummariescalculating", function (e, args) {
    // Handle event  
});

注: jQuery の live 関数は、ハンドラーに添付した後に一部の DOM 要素が追加される場合に使用されます。

イベント参照チャート

イベント	説明	キャンセル可能
dropDownOpening	特定の列集計のドロップダウンが開く前に発生します
dropDownOpened	特定の列のフィルター ドロップダウンが開いた後に発生します
dropDownClosing	集計列のドロップダウンが閉じ始める前に発生します
dropDownClosed	集計列ドロップダウンが完全に閉じた後に発生します
summariesCalculating	集計計算を行う前に発生します
summariesCalculated	集計計算を完全に行う前に発生します
summariesMethodSelectionChanged	ユーザーがチェックボックスから集計メソッドを選択すると発生します
summariesTogling	集計行が切り替え始める前にイベントが発生します
summariesToggled	集計行が切り替えられた後にイベントが発生します
dropDownOKClicked	ドロップダウンで OK ボタンを押すとイベントが発生します
dropDownCancelClicked	ドロップダウンで [キャンセル] ボタンを押すとイベントが発生します

関連トピック

列集計を有効にする

igGrid 構成: 列集計