AutoFilteringColumn イベント

概要

ユーザーが列のフィルタリングを行ったときに発生します。

書式

[JavaScript]

FpSpread1.addEventListener("AutoFilteringColumn", handler, ...)

または

FpSpread1.onAutoFilteringColumn = handler

[HTMLタグのインライン属性で指定]

引数

event.col
フィルタの対象となる列のインデックス
event.filterString
フィルタの基準とする文字列
event.cancel
操作をキャンセルするかどうか
event.spread
イベントを発生させたSpread オブジェクト

戻り値

なし

解説

このイベントは、ユーザーがドロップダウンフィルタリストからいずれかの項目を選択したときに発生します。

クライアントがフィルタリング要求をサーバーに送信する直前に、クライアント側でAutoFilteringColumnイベントが発生します。その後、フィルタリング要求が取り消されなければ、クライアントはこの要求をサーバーに送信します。

たとえば (FpSpread1.ActiveSheetView.AutoFilterColumn(1,"apple")) のように、コードによって列をフィルタリングする場合は、クライアント側のAutoFilteringColumnイベントは発生しません。

サンプル

次のサンプル JavaScript コードは、クライアント側 Spread に対してこのイベントをマッピングします。

JavaScript

window.onload = init;
function init() {
    var spread = document.getElementById("FpSpread1");
    if (spread.addEventListener) {
        spread.addEventListener("AutoFilteringColumn", autofilter, false);
    }
    else {
        spread.onAutoFilteringColumn = autofilter;
    }
}
function autofilter(event) {
    alert(event.filterString);
}