@mescius/spread-sheets 18.2.1 → 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.1",
+  "version": "18.2.3",
   "main": "index.js",
   "description":"A Complete Microsoft Excel-like JavaScript Spreadsheet for Enterprise Applications",
   "scripts": {},

package/styles/gc.spread.sheets.css

@@ -3665,6 +3665,8 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
   background-color: transparent;
   color: black;
   width: 60px;
+  padding: 1px 0px;
+  text-align: center;
 }
 .gc-panel-defer-layout-right-button:disabled {
   color: #c6bfbe;
@@ -5431,6 +5433,9 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
 .gc-sort-dialog-body > .confirm-class {
   margin-bottom: 2px;
 }
+.gc-sort-dialog-body input.selectable-item {
+  margin-top: 0px;
+}
 
 .gc-sort-more-options {
   position: absolute;

package/styles/gc.spread.sheets.excel2013darkGray.css

@@ -3705,6 +3705,8 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
   background-color: #d4d4d4;
   color: black;
   width: 60px;
+  padding: 1px 0px;
+  text-align: center;
 }
 .gc-panel-defer-layout-right-button:disabled {
   color: #c6bfbe;
@@ -5475,6 +5477,9 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
 .gc-sort-dialog-body > .confirm-class {
   margin-bottom: 2px;
 }
+.gc-sort-dialog-body input.selectable-item {
+  margin-top: 0px;
+}
 
 .gc-sort-more-options {
   position: absolute;

package/styles/gc.spread.sheets.excel2013lightGray.css

@@ -3710,6 +3710,8 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
   background-color: transparent;
   color: black;
   width: 60px;
+  padding: 1px 0px;
+  text-align: center;
 }
 .gc-panel-defer-layout-right-button:disabled {
   color: #c6bfbe;
@@ -5480,6 +5482,9 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
 .gc-sort-dialog-body > .confirm-class {
   margin-bottom: 2px;
 }
+.gc-sort-dialog-body input.selectable-item {
+  margin-top: 0px;
+}
 
 .gc-sort-more-options {
   position: absolute;

package/styles/gc.spread.sheets.excel2013white.css

@@ -3697,6 +3697,8 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
   background-color: white;
   color: black;
   width: 60px;
+  padding: 1px 0px;
+  text-align: center;
 }
 .gc-panel-defer-layout-right-button:disabled {
   color: #c6bfbe;
@@ -5467,6 +5469,9 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
 .gc-sort-dialog-body > .confirm-class {
   margin-bottom: 2px;
 }
+.gc-sort-dialog-body input.selectable-item {
+  margin-top: 0px;
+}
 
 .gc-sort-more-options {
   position: absolute;

package/styles/gc.spread.sheets.excel2016black.css

@@ -3708,6 +3708,8 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
   background-color: transparent;
   color: #D7D5CD;
   width: 60px;
+  padding: 1px 0px;
+  text-align: center;
 }
 .gc-panel-defer-layout-right-button:disabled {
   color: #575555;
@@ -5478,6 +5480,9 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
 .gc-sort-dialog-body > .confirm-class {
   margin-bottom: 2px;
 }
+.gc-sort-dialog-body input.selectable-item {
+  margin-top: 0px;
+}
 
 .gc-sort-more-options {
   position: absolute;

package/styles/gc.spread.sheets.excel2016colorful.css

@@ -3701,6 +3701,8 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
   background-color: white;
   color: black;
   width: 60px;
+  padding: 1px 0px;
+  text-align: center;
 }
 .gc-panel-defer-layout-right-button:disabled {
   color: #c6bfbe;
@@ -5471,6 +5473,9 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
 .gc-sort-dialog-body > .confirm-class {
   margin-bottom: 2px;
 }
+.gc-sort-dialog-body input.selectable-item {
+  margin-top: 0px;
+}
 
 .gc-sort-more-options {
   position: absolute;

package/styles/gc.spread.sheets.excel2016darkGray.css

@@ -3697,6 +3697,8 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
   background-color: #d4d4d4;
   color: black;
   width: 60px;
+  padding: 1px 0px;
+  text-align: center;
 }
 .gc-panel-defer-layout-right-button:disabled {
   color: #a7a1a1;
@@ -5467,6 +5469,9 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
 .gc-sort-dialog-body > .confirm-class {
   margin-bottom: 2px;
 }
+.gc-sort-dialog-body input.selectable-item {
+  margin-top: 0px;
+}
 
 .gc-sort-more-options {
   position: absolute;