@mescius/spread-sheets 18.2.2 → 18.2.3

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

@@ -25693,23 +25693,30 @@ declare module GC{
                  */
                 getSparkline(row: number,  column: number): GC.Spread.Sheets.Sparklines.Sparkline;
                 /**
-                 * Gets the style information for a specified cell in the specified sheet area.
-                 * @param {number} row The row index.
-                 * @param {number} column The column index.
+                 * Gets the style information for a cell, row, column, or the sheet default based on the provided indices.
+                 * Special Index Behavior:
+                 * - When rowIndex is -1 and columnIndex is a valid column index (>= 0), returns the style at the **column level** for the specified column.
+                 * - When columnIndex is -1 and rowIndex is a valid row index (>= 0), returns the style at the **row level** for the specified row.
+                 * - When both rowIndex and columnIndex are -1, returns the **sheet's default style** (not associated with any specific cell, row, or column).
+                 * - When both rowIndex and columnIndex are >= 0 (default case), returns the **cell's style** at the specified (row, column), which is resolved based on the priority: Cell > Row > Column > Default.
+                 * @param {number} row The row index. Use -1 to query column-level or default style.
+                 * @param {number} column The column index. Use -1 to query row-level or default style.
                  * @param {GC.Spread.Sheets.SheetArea} [sheetArea] The sheet area. If this parameter is not provided, it defaults to `viewport`.
-                 * @returns {GC.Spread.Sheets.Style} Returns the cell style of the specified cell.
+                 * @returns {GC.Spread.Sheets.Style} The resolved Style object based on the index combination.
+                 *
                  * @example
                  * ```javascript
-                 * //This example uses the getStyle method.
-                 * var style = new GC.Spread.Sheets.Style();
-                 * style.backColor = "red";
-                 * style.borderLeft =new GC.Spread.Sheets.LineBorder("blue",GC.Spread.Sheets.LineStyle.medium);
-                 * style.borderTop = new GC.Spread.Sheets.LineBorder("blue",GC.Spread.Sheets.LineStyle.medium);
-                 * style.borderRight = new GC.Spread.Sheets.LineBorder("blue",GC.Spread.Sheets.LineStyle.medium);
-                 * style.borderBottom = new GC.Spread.Sheets.LineBorder("blue",GC.Spread.Sheets.LineStyle.medium);
-                 * activeSheet.setStyle(1,1,style,GC.Spread.Sheets.SheetArea.viewport);
-                 * var cstyle = activeSheet.getStyle(1,1,GC.Spread.Sheets.SheetArea.viewport);
-                 * alert(cstyle.backColor);
+                 * // 1. Get the style of a specific cell (original usage)
+                 * var cellStyle = activeSheet.getStyle(1, 1, GC.Spread.Sheets.SheetArea.viewport);
+                 *
+                 * // 2. Get the column-level style for column index 1 (column B)
+                 * var columnStyle = activeSheet.getStyle(-1, 1, GC.Spread.Sheets.SheetArea.viewport);
+                 *
+                 * // 3. Get the row-level style for row index 2 (row 3)
+                 * var rowStyle = activeSheet.getStyle(2, -1, GC.Spread.Sheets.SheetArea.viewport);
+                 *
+                 * // 4. Get the sheet's default style
+                 * var defaultStyle = activeSheet.getStyle(-1, -1, GC.Spread.Sheets.SheetArea.viewport);
                  * ```
                  */
                 getStyle(row: number,  column: number,  sheetArea?: GC.Spread.Sheets.SheetArea): GC.Spread.Sheets.Style;
@@ -26798,18 +26805,36 @@ declare module GC{
                  */
                 setSparkline(row: number,  col: number,  dataRange: GC.Spread.Sheets.Range | string,  dataOrientation: GC.Spread.Sheets.Sparklines.DataOrientation,  sparklineType: GC.Spread.Sheets.Sparklines.SparklineType,  sparklineSetting: GC.Spread.Sheets.Sparklines.SparklineSetting,  dateAxisRange?: GC.Spread.Sheets.Range | string,  dateAxisOrientation?: GC.Spread.Sheets.Sparklines.DataOrientation): GC.Spread.Sheets.Sparklines.Sparkline;
                 /**
-                 * Sets the style information for a specified cell in the specified sheet area.
-                 * @param {number} row The row index.
-                 * @param {number} column The column index.
-                 * @param {GC.Spread.Sheets.Style} value The cell style.
+                 * Sets the style information for a cell, row, column, or the worksheet default based on the provided indices.
+                 *
+                 * Special Index Behavior:
+                 * - When rowIndex is -1 and columnIndex is a valid column index (>= 0), sets the **column-level style** for the specified column.
+                 * - When columnIndex is -1 and rowIndex is a valid row index (>= 0), sets the **row-level style** for the specified row.
+                 * - When both rowIndex and columnIndex are -1, sets the **worksheet's default style** (applies to all cells unless overridden).
+                 * - When both rowIndex and columnIndex are >= 0 (default case), sets the **cell style** for the specified (row, column) in the given sheet area.
+                 *
+                 * @param {number} row The zero-based row index. Use -1 to target column-level or default style.
+                 * @param {number} col The zero-based column index. Use -1 to target row-level or default style.
+                 * @param {GC.Spread.Sheets.Style} value The Style object containing the style properties to apply.
                  * @param {GC.Spread.Sheets.SheetArea} [sheetArea] The sheet area. If this parameter is not provided, it defaults to `viewport`.
+                 *
                  * @example
                  * ```javascript
-                 * //This example uses the setStyle method.
-                 * var style = new GC.Spread.Sheets.Style();
-                 * style.backColor = "lightgreen";
-                 * style.backgroundImage = "./css/images/quarter1.png";
-                 * activeSheet.setStyle(1,1,style,GC.Spread.Sheets.SheetArea.viewport);
+                 *  var style = new GC.Spread.Sheets.Style();
+                 *  style.backColor = "lightgreen";
+                 *  sheet.setStyle(1, 1, style, GC.Spread.Sheets.SheetArea.viewport);
+                 *  // 2. Set the column-level style for column index 2 (column C)
+                 *  var columnStyle = new GC.Spread.Sheets.Style();
+                 *  columnStyle.backColor = "yellow";
+                 *  sheet.setStyle(-1, 2, columnStyle, GC.Spread.Sheets.SheetArea.viewport);
+                 *  // 3. Set the row-level style for row index 3 (row 4)
+                 *  var rowStyle = new GC.Spread.Sheets.Style();
+                 *  rowStyle.backColor = "lightcoral";
+                 *  sheet.setStyle(3, -1, rowStyle, GC.Spread.Sheets.SheetArea.viewport);
+                 *  // 4. Set the worksheet's default style
+                 *  var defaultStyle = new GC.Spread.Sheets.Style();
+                 *  defaultStyle.backColor = "lightblue";
+                 *  sheet.setStyle(-1, -1, defaultStyle, GC.Spread.Sheets.SheetArea.viewport);
                  * ```
                  */
                 setStyle(row: number,  col: number,  value: GC.Spread.Sheets.Style,  sheetArea?: GC.Spread.Sheets.SheetArea): void;

package/package.json

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