4.2.2.3. TMtableプログラミング-APIの紹介¶
TMtableのタプルの操作やデータの設定・取得の方法を紹介します。
各機能の詳細はAPIリストを参照してください。
4.2.2.3.1. タプルへのデータ設定¶
タプル内にあるテキストボックスなどに値を設定する場合には以下のようなAPIを利用すると便利です。
append(data, exclude)最下行にタプルを追加し、そのタプルに対しdataを設定 insertUpper(tupleId, data, exclude)指定タプルの上にタプルを挿入、そのタプルに対しdataを設定 insertUnder(tupleId, data, exclude)指定タプルの下にタプルを挿入、そのタプルに対しdataを設定 setTupleData(tupleId, data, exclude)指定タプルに対しdataを設定 replaceAll(datas, exclude)全行削除後、datas(配列)の分だけ行追加しデータを設定します ※タプルIDを復元する replaceAllNewTupleId(datas, exclude)全行削除後、datas(配列)の分だけ行追加しデータを設定します ※タプルIDを復元せずに新たなタプルIDを付与 appendAllNewTupleId(datas, exclude)datas(配列)の分だけ行追記しデータを設定します ※タプルIDを復元せずに新たなタプルIDを付与下記は、TMtableに行を追加し、text1に”txt1”をtext2に”txt2”を設定する例です。excludeにtext3が指定されているため、text3は値が設定されません。// TMtableの取り出し var tmtable = KAIDEN.getGadget("ガジェットID").tmtables["TMテーブルID"]; //タプルを追加するとともにデータを設定 tmtable.append({text1:"txt1", text2:"txt2", text3:"txt3"}, {text3:true});
4.2.2.3.2. タプルのデータ取得¶
getTupleData(tupleId, includeLabel)特定のタプルのデータをjavascriptオブジェクトの形式で返却 getCount()Tmtableの行数を返却 getAvailabilityTupleIds()現在有効なタプルIDを配列で返却 getDataSet()タプルデータの配列をjavascriptオブジェクトの形式で返却 getColumnValues(fldName)タプルのうち特定のフィールドキー(もしくはフィールドキーの配列)の入力データをすべて返却.
4.2.2.3.3. タプルに対するイベント処理¶
4.2.2.3.3.1. タプル追加(挿入)直前¶
// TMtableの取り出し var tmtable = KAIDEN.getGadget("ガジェットID").tmtables["TMテーブルID"]; //タプル追加(挿入)直前イベント tmtable.addEventPreNewRow(function(tupleId, tmtableAccessor) { //引数:tupleId :挿入起点となるタプルID //引数:tmtableAccessor:当該TMtableへのAccessor });
4.2.2.3.3.2. タプル追加(挿入)直後(データ設定前)¶
// TMtableの取り出し var tmtable = KAIDEN.getGadget("ガジェットID").tmtables["TMテーブルID"]; //タプル追加(挿入)直後(データ設定前)イベント tmtable.addEventPostNewRowBeforeSetData(function(tupleId, tmtableAccessor, data) { //引数:tupleId :新たに挿入されたタプルID //引数:tmtableAccessor:当該TMtableへのAccessor //引数:data :挿入されたタプルに設定しようとしている値 });
4.2.2.3.3.3. タプル追加(挿入)直後(データ設定後)¶
// TMtableの取り出し var tmtable = KAIDEN.getGadget("ガジェットID").tmtables["TMテーブルID"]; //タプル追加(挿入)直後(データ設定後)イベント tmtable.addEventPostNewRow(function(tupleId, tmtableAccessor, data) { //引数:tupleId :新たに挿入されたタプルID //引数:tmtableAccessor:当該TMtableへのAccessor //引数:data :挿入されたタプルに設定された値 });
4.2.2.3.3.4. タプル削除時¶
// TMtableの取り出し var tmtable = KAIDEN.getGadget("ガジェットID").tmtables["TMテーブルID"]; //タプル削除時イベント tmtable.addEventDecreaseRowFunc(function() { });