概要

ページのコールバックを行います。

書式

FpSpread1.CallBack(cmd);

引数

製品で予約されるコマンド名

下記のコマンド名は製品が使用する文字列です。これらの文字列は製品によって予約されています、アプリケーション独自のコールバック処理にこれらの文字列を使用しない様に注意してください。アプリケーション独自のコールバック処理にこれらの文字列を使用しても製品はそれらの処理を無視し、あらかじめ製品で定められた処理を実行します。

FpSpreadクラスのイベントに対応するコマンド名を引数に指定してCallBackメソッドを実行すると、SPREADのコマンドバーの各ボタンを押した時と同じ動作を得ることができます。

例えば、ChildViewコマンドは次の様になります。ここで指定するrelationnameは表示する階層を表すリレーションの名称です。

FpSpread("FpSpread1").CallBack("ChildView,relationname");

ExpandViewコマンドは次の様になります。ここで指定するrownumは0から開始する行インデックスです。例えば「2」を指定した場合、親シートの3行目を展開し子階層を表示します。親以下の階層の行を展開したい場合、その階層におけるシート名を指定する必要があります。

FpSpread("FpSpread1").CallBack("ExpandView,rownum");

次のコードは、指定した階層の4行目を展開します。

function DoCallBack() { var ss = event.spread; ss.CallBack("ExpandView,3"); }

Pageコマンドは次の様になります。ここで指定するpagenumは、アクティブシートにおける0から開始するページ番号です。例えば「2」を指定した場合、アクティブシートを3ページ目まで移動します。

FpSpread("FpSpread1").CallBack("Page,pagenum");

注意： Spreadコントロールでイベント発生中にCallBackメソッドを使用すると、無効な状態となる可能性があります。この事態を防止するには、次のようなコードを試してみてください。

アプリケーション独自のコマンド名

製品で予約されていない文字列を CallBack メソッドのコマンド名に指定すると、サーバー側でButtonCommand イベントが発生します。コマンド名に指定した文字列はイベント引数SpreadCommandEventArgs クラスのCommandName プロパティから取得できます。つまり、アプリケーション独自のコマンド名を指定することでButtonCommand イベントの中で各コールバックを識別することができます。

protected void FpSpread1_ButtonCommand(object sender, FarPoint.Web.Spread.SpreadCommandEventArgs e)
{
    if(e.CommandName == "MyCommand")
        FpSpread1.Sheets[0].Cells[0, 0].Text = "My Command Worked";
    }
}

Private Sub FpSpread1_ButtonCommand(ByVal sender As Object, ByVal e As FarPoint.Web.Spread.SpreadCommandEventArgs) Handles FpSpread1.ButtonCommand
    If e.CommandName = "MyCommand" Then
        FpSpread1.Sheets(0).Cells(0, 0).Text = "My Command Worked"
    End If
End Sub

JavaScriptの記述

function ButtonClick() {
    FpSpread("FpSpread1").CallBack("MyCommand");
}

戻り値

なし

サンプル

次に、組み込みコマンドの1つとともにこのメソッドを使用したサンプルコードを示します。 このメソッドを含むクライアント側スクリプトは、次のようになります。

function SortIt() {
    FpSpread("FpSpread1").CallBack("SortColumn");
}

ここでは製品で予約されたコマンド名「Update」を指定してCallBackメソッドを実行します。サーバー側ではUpdateCommand イベントが発生します。

function window.onload() {
　   var spread = FpSpread("FpSpread1");
        if (spread.addEventListener) {
        spread.addEventListener("onDataChanged", DoCallBack, false);
    }
    else {
        spread.onDataChanged = DoCallBack;
    }
}

function DoCallBack() {
    var spread = FpSpread("FpSpread1");
    spread.UpdatePostbackData();
    spread.CallBack("Update");
}

© MESCIUS inc. All rights reserved.