@mescius/spread-sheets 18.2.2 → 18.2.4

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.4",
   "main": "index.js",
   "description":"A Complete Microsoft Excel-like JavaScript Spreadsheet for Enterprise Applications",
   "scripts": {},

package/styles/gc.spread.sheets.css

@@ -1288,6 +1288,17 @@ div.gc-search-outer-div input::-ms-clear {
   white-space: pre;
 }
 
+.gc-ui-contextmenu-sheet-tab-text {
+  display: inline-block;
+  box-sizing: border-box;
+  width: 164px;
+  padding-left: 0;
+  padding-right: 2px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 .gc-ui-contextmenu-disable {
   color: #b1b1b1 !important;
 }
@@ -2034,6 +2045,9 @@ input.gc-checkbox-cell-type-input[type=checkbox]:after {
   font-size: 12px;
   padding: 1px 4px;
   border: 1px solid #000;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 .gc-sjs-paste-special-dialog-container .gc-sjs-paste-special-dialog-content .gc-sjs-transform-formula-editor-input:focus-visible {
   border-width: 1px;
@@ -7710,6 +7724,9 @@ div[gcUIElement=gcSpread] .gc-base-spread-div {
 .gc-ui-none-icon-contextmenu-container .gc-ui-contextmenu-icon {
   margin-right: 12px;
 }
+.gc-ui-none-icon-contextmenu-container .gc-ui-contextmenu-sheet-tab-text {
+  width: 152px;
+}
 
 .gc-ui-contextmenu-search-label {
   margin-left: 30px;

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

@@ -1329,6 +1329,17 @@ div.gc-search-outer-div input::-ms-clear {
   white-space: pre;
 }
 
+.gc-ui-contextmenu-sheet-tab-text {
+  display: inline-block;
+  box-sizing: border-box;
+  width: 164px;
+  padding-left: 0;
+  padding-right: 2px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 .gc-ui-contextmenu-disable {
   color: #b1b1b1 !important;
 }
@@ -2074,6 +2085,9 @@ input.gc-checkbox-cell-type-input[type=checkbox]:after {
   font-size: 12px;
   padding: 1px 4px;
   border: 1px solid #000;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 .gc-sjs-paste-special-dialog-container .gc-sjs-paste-special-dialog-content .gc-sjs-transform-formula-editor-input:focus-visible {
   border-width: 1px;

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

@@ -1329,6 +1329,17 @@ div.gc-search-outer-div input::-ms-clear {
   white-space: pre;
 }
 
+.gc-ui-contextmenu-sheet-tab-text {
+  display: inline-block;
+  box-sizing: border-box;
+  width: 164px;
+  padding-left: 0;
+  padding-right: 2px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 .gc-ui-contextmenu-disable {
   color: #b1b1b1 !important;
 }
@@ -2079,6 +2090,9 @@ input.gc-checkbox-cell-type-input[type=checkbox]:after {
   font-size: 12px;
   padding: 1px 4px;
   border: 1px solid #000;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 .gc-sjs-paste-special-dialog-container .gc-sjs-paste-special-dialog-content .gc-sjs-transform-formula-editor-input:focus-visible {
   border-width: 1px;

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

@@ -1320,6 +1320,17 @@ div.gc-search-outer-div input::-ms-clear {
   white-space: pre;
 }
 
+.gc-ui-contextmenu-sheet-tab-text {
+  display: inline-block;
+  box-sizing: border-box;
+  width: 164px;
+  padding-left: 0;
+  padding-right: 2px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 .gc-ui-contextmenu-disable {
   color: #b1b1b1 !important;
 }
@@ -2066,6 +2077,9 @@ input.gc-checkbox-cell-type-input[type=checkbox]:after {
   font-size: 12px;
   padding: 1px 4px;
   border: 1px solid #000;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 .gc-sjs-paste-special-dialog-container .gc-sjs-paste-special-dialog-content .gc-sjs-transform-formula-editor-input:focus-visible {
   border-width: 1px;

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

@@ -1331,6 +1331,17 @@ div.gc-search-outer-div input::-ms-clear {
   white-space: pre;
 }
 
+.gc-ui-contextmenu-sheet-tab-text {
+  display: inline-block;
+  box-sizing: border-box;
+  width: 164px;
+  padding-left: 0;
+  padding-right: 2px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 .gc-ui-contextmenu-disable {
   color: #b1b1b1 !important;
 }
@@ -2077,6 +2088,9 @@ input.gc-checkbox-cell-type-input[type=checkbox]:after {
   font-size: 12px;
   padding: 1px 4px;
   border: 1px solid #000;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 .gc-sjs-paste-special-dialog-container .gc-sjs-paste-special-dialog-content .gc-sjs-transform-formula-editor-input:focus-visible {
   border-width: 1px;

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

@@ -1325,6 +1325,17 @@ div.gc-search-outer-div input::-ms-clear {
   white-space: pre;
 }
 
+.gc-ui-contextmenu-sheet-tab-text {
+  display: inline-block;
+  box-sizing: border-box;
+  width: 164px;
+  padding-left: 0;
+  padding-right: 2px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 .gc-ui-contextmenu-disable {
   color: #b1b1b1 !important;
 }
@@ -2070,6 +2081,9 @@ input.gc-checkbox-cell-type-input[type=checkbox]:after {
   font-size: 12px;
   padding: 1px 4px;
   border: 1px solid #000;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 .gc-sjs-paste-special-dialog-container .gc-sjs-paste-special-dialog-content .gc-sjs-transform-formula-editor-input:focus-visible {
   border-width: 1px;

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

@@ -1321,6 +1321,17 @@ div.gc-search-outer-div input::-ms-clear {
   white-space: pre;
 }
 
+.gc-ui-contextmenu-sheet-tab-text {
+  display: inline-block;
+  box-sizing: border-box;
+  width: 164px;
+  padding-left: 0;
+  padding-right: 2px;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 .gc-ui-contextmenu-disable {
   color: #b1b1b1 !important;
 }
@@ -2066,6 +2077,9 @@ input.gc-checkbox-cell-type-input[type=checkbox]:after {
   font-size: 12px;
   padding: 1px 4px;
   border: 1px solid #000;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 .gc-sjs-paste-special-dialog-container .gc-sjs-paste-special-dialog-content .gc-sjs-transform-formula-editor-input:focus-visible {
   border-width: 1px;