イベント

SpreadJSには、シート関連の多数のイベントがあります。特定のイベントの発生時に、アプリケーションで指定のアクションが実行されるように定義できます。

シートイベントをバインドするには、シートのbindおよびunbindメソッドを使用します。すべてのイベントをバインド解除するには、unbindAllメソッドを使用します。シートのbindおよびunbindは、次の例に示すように、jqueryのbindおよびunbindと同様に処理できます。 いくつかのイベントをトリガさせる可能性のあるタスクを実行する場合、シートによるこれらのイベントのトリガを阻止するには、suspendEventメソッドを使用すると、イベントの発生を抑制できます。タスクの完了後、resumeEventメソッドを使用すると、イベントのトリガを再開できます。次に、この例を示します。
var spreadNS = GC.Spread.Sheets; window.onload = function () { var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 1 }); initSpread(spread); }; function initSpread(spread) { var sheet = spread.getSheet(0); sheet.suspendPaint(); setStatus(sheet); sheet.setValue(2, 2, "クリックして、キーボードで文字を入力してください!"); sheet.addSpan(2, 2, 1, 5); sheet.getRange(2, 2, 1, 5).setBorder(new spreadNS.LineBorder("Black", spreadNS.LineStyle.thin), { all: true }); sheet.setValue(4, 2, "黒枠の空白セルをダブルクリックしてください!"); sheet.addSpan(4, 2, 1, 5); sheet.addSpan(5, 2, 1, 5); sheet.getRange(5, 2, 1, 5).setBorder(new spreadNS.LineBorder("Black", spreadNS.LineStyle.thin), { all: true }); sheet.setValue(7, 2, "ここをダブルクリックしてください!"); sheet.addSpan(7, 2, 1, 5); sheet.getRange(7, 2, 1, 5).setBorder(new spreadNS.LineBorder("Black", spreadNS.LineStyle.thin), { all: true }); sheet.setValue(9, 2, "黒枠の空白セルをダブルクリックし、もう一度クリックしてください!"); sheet.addSpan(9, 2, 1, 7); sheet.addSpan(10, 2, 1, 5); sheet.getRange(10, 2, 1, 5).setBorder(new spreadNS.LineBorder("Black", spreadNS.LineStyle.thin), { all: true }); sheet.resumePaint(); sheet.bind(GC.Spread.Sheets.Events.ColumnChanging, function (sender, info) { //insert column if (info.propertyName === "addColumns") { _getElementById("status").innerHTML = "ColumnChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "ColumnChanging: 列の追加(" + "列:" + info.col + ")"; } //delete column if (info.propertyName === "deleteColumns") { _getElementById("status").innerHTML = "ColumnChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "ColumnChanging: 列の削除(" + "列:" + info.col + ")"; } //unhide column if (info.propertyName === "isVisible" && info.newValue === true) { _getElementById("status").innerHTML = "ColumnChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "ColumnChanging: 列の再表示(" + "列:" + info.col + ")"; } //hide column if (info.propertyName === "isVisible" && info.newValue === false) { _getElementById("status").innerHTML = "ColumnChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "ColumnChanging: 列の非表示(" + "列:" + info.col + ")"; } }); sheet.bind(GC.Spread.Sheets.Events.ColumnChanged, function (sender, info) { //insert column if (info.propertyName === "addColumns") { _getElementById("status").innerHTML = "ColumnChangedイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "ColumnChanged: 列の挿入(" + "列:" + info.col + ")"; } //delete column if (info.propertyName === "deleteColumns") { _getElementById("status").innerHTML = "ColumnChangedイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "ColumnChanged: 列の削除(" + "列:" + info.col + ")"; } //unhide column if (info.propertyName === "isVisible" && info.newValue === true) { _getElementById("status").innerHTML = "ColumnChangedイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "ColumnChanged: 列の再表示(" + "列:" + info.col + ")"; } //hide column if (info.propertyName === "isVisible" && info.newValue === false) { _getElementById("status").innerHTML = "ColumnChangedイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "ColumnChanged: 列の非表示(" + "列:" + info.col + ")"; } }); //RowChanging sheet.bind(GC.Spread.Sheets.Events.RowChanging, function (sender, info) { //insert row if (info.propertyName === "addRows") { _getElementById("status").innerHTML = "RowChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "RowChanging: 行の挿入(" + "行:行:" + info.row + ")"; } //delete row if (info.propertyName === "deleteRows") { _getElementById("status").innerHTML = "RowChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "RowChanging: 行の削除(" + "行:" + info.row + ")"; } //unhide row if (info.propertyName === "isVisible" && info.newValue === true) { _getElementById("status").innerHTML = "RowChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "RowChanging: 行の再表示(" + "行:" + info.row + ")"; } //hide row if (info.propertyName === "isVisible" && info.newValue === false) { _getElementById("status").innerHTML = "RowChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "RowChanging: 行の非表示(" + "行:" + info.row + ")"; } }); sheet.bind(GC.Spread.Sheets.Events.RowChanged, function (sender, info) { //insert row if (info.propertyName === "addRows") { _getElementById("status").innerHTML = "RowChangedイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "RowChanged: 行の挿入(" + "行:" + info.row + ")"; } //delete row if (info.propertyName === "deleteRows") { _getElementById("status").innerHTML = "RowChangedイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "RowChanged: 行の削除(" + "行:" + info.row + ")"; } //unhide row if (info.propertyName === "isVisible" && info.newValue === true) { _getElementById("status").innerHTML = "RowChangedイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "RowChanged: 行の再表示(" + "行:" + info.row + ")"; } //hide row if (info.propertyName === "isVisible" && info.newValue === false) { _getElementById("status").innerHTML = "RowChangedイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "RowChanged: 行の非表示(" + "行:" + info.row + ")"; } }); sheet.bind(spreadNS.Events.EditorStatusChanged, function () { setStatus(sheet); }); sheet.bind(spreadNS.Events.SelectionChanging, function (e, info) { _getElementById("status").innerHTML = "SelectionChangingイベントが呼び出されました!"; _getElementById("showSheetEvents").innerHTML = "新しい選択(" + "行:" + info.newSelections[0].row + ", " + "列:" + info.newSelections[0].col + ", " + "行数:" + info.newSelections[0].rowCount + ", " + "列数:" + info.newSelections[0].colCount + ")"; }) }; function setStatus(sheet) { var statusNow = sheet.editorStatus(); if (statusNow === spreadNS.EditorStatus.ready) { _getElementById("status").innerHTML = "編集の状態:準備完了!"; _getElementById("showSheetEvents").innerHTML = "セルは編集中ではありません。"; } else if (statusNow === spreadNS.EditorStatus.enter) { _getElementById("status").innerHTML = "編集の状態:入力中!"; _getElementById("showSheetEvents").innerHTML = "セルは編集中です。矢印キーのいずれかを押すとそのセルから離れます。"; } else if (statusNow === spreadNS.EditorStatus.edit) { _getElementById("status").innerHTML = "編集の状態:編集中!"; _getElementById("showSheetEvents").innerHTML = "セルは編集中です。矢印キーを押してもセルから離れることはできません。"; } } function _getElementById(id) { return document.getElementById(id); }
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta name="spreadjs culture" content="ja-jp" /> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets/dist/gc.spread.sheets.all.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/ja/purejs/node_modules/@mescius/spread-sheets-resources-ja/dist/gc.spread.sheets.resources.ja.min.js" type="text/javascript"></script> <script src="$DEMOROOT$/spread/source/js/license.js" type="text/javascript"></script> <script src="app.js" type="text/javascript"></script> <link rel="stylesheet" type="text/css" href="styles.css"> </head> <body> <div class="sample-tutorial"> <div id="ss" class="sample-spreadsheets"></div> <div class="options-container"> <div class="option-row"> <label style="color:rgb(226,107,29);display:inline-block;font-family:Arial, Helvetica, sans-serif;font-size: 18px;font-weight: normal;height:30px;line-height: 30px " id="status">Settings</label> </div> <div class="option-row"> <textarea id="showSheetEvents" cols="40" rows="5" style="width: 80%"></textarea> </div> </div> </div> </body> </html>
.sample-tutorial { position: relative; height: 100%; overflow: hidden; } .sample-spreadsheets { width: calc(100% - 280px); height: 100%; overflow: hidden; float: left; } .options-container { float: right; width: 280px; padding: 12px; height: 100%; box-sizing: border-box; background: #fbfbfb; overflow: auto; } .option-row { font-size: 14px; padding: 5px; margin-top: 10px; } label { display: block; margin-bottom: 6px; } input { padding: 4px 6px; } input[type=button] { margin-top: 6px; display: block; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; }