@mescius/spread-sheets 17.0.7 → 17.0.9

package/dist/gc.spread.sheets.d.ts

@@ -12934,6 +12934,14 @@ declare module GC{
             }
 
 
+            export interface IRange{
+                row: number;
+                col: number;
+                rowCount: number;
+                colCount: number;
+            }
+
+
             export interface IRangeChangedEventArgs{
                 sheet: GC.Spread.Sheets.Worksheet;
                 sheetName: string;
@@ -13884,7 +13892,7 @@ declare module GC{
              * @property {boolean} [rowHeadersAsFrozenColumns] - Whether to treat the row headers as frozen columns when do save, default false.
              * @property {boolean} [columnHeadersAsFrozenRows] - Whether to treat the column headers as frozen rows when do save, default false.
              * @property {boolean} [includeAutoMergedCells] - Whether to include the automatically merged cells when do save, default false.
-             * @property {boolean} [includeCalcModelCache] - Whether to include the extra data of calculation. Can be faster when open the file with those data, default false.
+             * @property {boolean} [includeCalcModelCache] - [deprecated] Whether to include the extra data of calculation. Can be faster when open the file with those data, default false.
              * @property {boolean} [includeUnusedNames] - Whether to include the unused custom name when do save, default true.
              * @property {boolean} [includeEmptyRegionCells] - Whether to include any empty cells(cells with no data or only style) outside the used data range, default true.
              * @property {string} [password] - Set the password to open the workbook.
@@ -16716,13 +16724,16 @@ declare module GC{
                 /**
                  * Gets or sets the formula for the cell.
                  * @param {string} [value] The cell formula.
+                 * @param {boolean} [autoAdjustReference] Whether to adjust the relative reference of each cell. It's false if omitted.
                  * @returns {string|GC.Spread.Sheets.CellRange} If no value is set, returns the cell formula; otherwise, returns the cell.
                  * @example
                  * ```
                  * activeSheet.getCell(0,2).formula("DATEDIF(DATE(2003,1,1),DATE(2016,1,1),\"Y\")");
+                 * activeSheet.getRange(2,2,100,1).formula("=A3+$A$1"); // all the cells are "=A3+$A$1"
+                 * activeSheet.getRange(2,2,100,1).formula("=A3+$A$1", true); // the first cell is "=A3+$A$1", the second cell is "=A4+$A$1", ...
                  * ```
                  */
-                formula(value?: string): any;
+                formula(value?: string,  autoAdjustReference?: boolean): any;
                 /**
                  * Gets or sets the horizontal alignment of the contents of the cell.
                  * @param {GC.Spread.Sheets.HorizontalAlign} [value] The horizontal alignment.
@@ -22760,6 +22771,17 @@ declare module GC{
                  * ```
                  */
                 addSpan(row: number,  col: number,  rowCount: number,  colCount: number,  sheetArea?: GC.Spread.Sheets.SheetArea): void;
+                /**
+                 * Adds a lot of spans to this sheet in the specified sheet area.
+                 * @param {Array} spans The span ranges, each range contains row, col, rowCount, colCount.
+                 * @param {GC.Spread.Sheets.SheetArea} [sheetArea] The sheet area. If this parameter is not given, it defaults to `viewport`.
+                 * @example
+                 * ```
+                 * //This example creates cell spans.
+                 * sheet.addSpans([{row: 0, col: 0, rowCount: 2, colCount: 2}, {row: 3, col: 0, rowCount: 3, colCount: 3}, {row: 7, col: 0, rowCount: 4, colCount: 4}], GC.Spread.Sheets.SheetArea.viewport);
+                 * ```
+                 */
+                addSpans(spans: GC.Spread.Sheets.IRange[],  sheetArea?: GC.Spread.Sheets.SheetArea): void;
                 /**
                  * Automatically fits the viewport column.
                  * @param {number} column The column index.
@@ -50663,11 +50685,11 @@ declare module GC{
                      *   return item['cost'] + '$';
                      * }
                      * var table = sheet.tables.add('tableSales', 0, 0, 5, 5);
-                     * var tableColumn1 = new GC.Spread.Sheets.Tables.Tables.TableColumn(1, "orderDate", "Order Date", "d/M/yy");
-                     * var tableColumn2 = new GC.Spread.Sheets.Tables.Tables.TableColumn(2, "item", "Item");
-                     * var tableColumn3 = new GC.Spread.Sheets.Tables.Tables.TableColumn(3, "units", "Units");
-                     * var tableColumn4 = new GC.Spread.Sheets.Tables.Tables.TableColumn(4, "cost", "Cost", null, null, convert);
-                     * var tableColumn5 = new GC.Spread.Sheets.Tables.Tables.TableColumn(5, "isMakeMoney", "IsMakeMoney", null, new GC.Spread.Sheets.CellTypes.CheckBox());
+                     * var tableColumn1 = new GC.Spread.Sheets.Tables.TableColumn(1, "orderDate", "Order Date", "d/M/yy");
+                     * var tableColumn2 = new GC.Spread.Sheets.Tables.TableColumn(2, "item", "Item");
+                     * var tableColumn3 = new GC.Spread.Sheets.Tables.TableColumn(3, "units", "Units");
+                     * var tableColumn4 = new GC.Spread.Sheets.Tables.TableColumn(4, "cost", "Cost", null, null, convert);
+                     * var tableColumn5 = new GC.Spread.Sheets.Tables.TableColumn(5, "isMakeMoney", "IsMakeMoney", null, new GC.Spread.Sheets.CellTypes.CheckBox());
                      * table.autoGenerateColumns(false);
                      *
                      * table.bind([tableColumn1, tableColumn2, tableColumn3, tableColumn4, tableColumn5], 'sales', data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mescius/spread-sheets",
-  "version": "17.0.7",
+  "version": "17.0.9",
   "main": "index.js",
   "description":"A Complete Microsoft Excel-like JavaScript Spreadsheet for Enterprise Applications",
   "scripts": {},