beforeCellUpdate イベント

beforeCellUpdate イベントハンドラは、セルが新しいデータまたはユーザー入力データによって更新される前に呼び出される関数です。このイベントは、editigModeオプションが"cell"に設定されている場合、キャンセルできます。このイベントは、更新を実行する前にセルの値をチェックするときや、セルの値に基づいてアラートメッセージを表示するときなど、さまざまな場合に役立ちます。

シンタックス

Javascript (Usage)
$(function () { %JQueryMemberName%イベントハンドラ関数を設定する $(".selector").wijgrid({ beforeCellUpdate : function (e, args) { } }); });

Javascript (Usage)

$(function () {
    %JQueryMemberName%イベントハンドラ関数を設定する 
    $(".selector").wijgrid({ 
        beforeCellUpdate : function (e, args) { 
     
        } 
    });
});

Javascript (Specification)
beforeCellUpdate = function ( e : Object, args : IBeforeCellUpdateEventArgs ) { };

パラメータ

e: jQuery.Event オブジェクト。
args: このイベントに関連付けられたデータ。

使用例

Javascript

// このサンプルでは、args.valueを使用して、ユーザーが"Acquired"列に入力した年をチェックします。// 入力された年が1990年より前、または今年より後の場合、イベントハンドラはfalseを返して更新をキャンセルし、ユーザーに警告メッセージを表示します。$("#element").wijgrid({ beforeCellUpdate: function(e, args) { switch (args.cell.column().dataKey) { case "Acquired": var $editor = args.cell.container().find("input"), value = $editor.wijinputnumber("getValue"), curYear = new Date().getFullYear(); if (value < 1990 || value > curYear) { $editor.addClass("ui-state-error"); alert("value must be between 1990 and " + curYear); $editor.focus(); return false; } args.value = value; break; } }});

解説

イベントには、型と名前のいずれかで連結できます。名前でイベントに連結する場合。$("#element").wijgrid({ beforeCellUpdate: function (e, args) {// ここにコードを記述します。}});型でイベントに連結する場合。$("#element").bind("wijgridbeforecellupdate", function (e, args) {// ここにコードを記述します。});

パラメータ

関連トピック

参照