Skip to main content

beforeResetRange

pro version only

This functionality requires PRO version of the DHTMLX Grid (or DHTMLX Suite) package.

fires before resetting the range

Usage​

beforeResetRange: (
    range: {
        xStart: string | number;
        xEnd: string | number;
        yStart: string | number;
        yEnd: string | number;
    }
) => boolean | void;

Parameters:

The callback of the event is called with the following parameters:

range(object) an object with the range coordinates that contains the following options:
  • xStart - (string | number) the starting column id
  • xEnd - (string | number) the ending column id
  • yStart - (string | number) the starting row id
  • yEnd - (string | number) the ending row id

Returns:

Return false to prevent resetting of the range; otherwise, true.

Example

const grid = new dhx.Grid("grid_container", {
    // other configuration
    rangeSelection: true
});

grid.range.events.on("beforeResetRange", (range) => {
    console.log("Resetting the range:", range);
    return false; // cancels resetting of the range
});

grid.range.setRange({ xStart: "a", yStart: "1" });
grid.range.resetRange(); // resetting of the range is canceled

Change log:

added in v9.2