@mescius/spread-sheets 17.1.10 → 18.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -8104,6 +8104,36 @@ declare module GC{
8104
8104
  * ```
8105
8105
  */
8106
8106
  subtotalType(fieldName: string, type?:GC.Pivot.SubtotalType): GC.Pivot.SubtotalType | void;
8107
+ /**
8108
+ * @description set or get whether the field displays subtotal information.
8109
+ * @param {string} fieldName Indicates the field name.
8110
+ * @param {boolean} position Indicates whether to display subtotal information for the field.
8111
+ * @returns {boolean}
8112
+ * @example
8113
+ * ```
8114
+ * var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
8115
+ * var sourceSheet = spread.getSheet(0)
8116
+ * var sheet = spread.getSheet(1);
8117
+ * var sourceData = [["Date","Buyer","Type","Amount"],
8118
+ * ["01-Jan","Mom","Fuel",74],
8119
+ * ["15-Jan","Mom","Food",235],
8120
+ * ["17-Jan","Dad","Sports",20],
8121
+ * ["21-Jan","Kelly","Books",125]];
8122
+ * sourceSheet.setArray(0, 0, sourceData);
8123
+ * sourceSheet.tables.add('sourceData', 0, 0, 5, 4);
8124
+ * var layout = GC.Spread.Pivot.PivotTableLayoutType.compact;
8125
+ * var theme = GC.Spread.Pivot.PivotTableThemes.medium2;
8126
+ * var options = {showRowHeader: true, showColumnHeader: true};
8127
+ * sheet.pivotTables.add("pivotTable_1", 'sourceData', 1, 1, layout, theme, options);
8128
+ * var pivotTable = sheet.pivotTables.get("pivotTable_1");
8129
+ * pivotTable.add("Date","Date",GC.Spread.Pivot.PivotTableFieldType.rowField);
8130
+ * pivotTable.add("Buyer","Buyer",GC.Spread.Pivot.PivotTableFieldType.rowField);
8131
+ * pivotTable.add("Type","Type",GC.Spread.Pivot.PivotTableFieldType.columnField);
8132
+ * pivotTable.add("Amount","Sum of Amount",GC.Spread.Pivot.PivotTableFieldType.valueField, GC.Pivot.SubtotalType.sum);
8133
+ * pivotTable.subtotalVisible("Buyer", false);
8134
+ * ```
8135
+ */
8136
+ subtotalVisible(fieldName: string, isVisible: boolean): boolean;
8107
8137
  /**
8108
8138
  * @description Stop update field util resumeFieldsLayout, it must be used in pairs with resumeFieldsLayout.
8109
8139
  */
@@ -8284,9 +8314,17 @@ declare module GC{
8284
8314
  * pivotTable.add("Amount","Sum of Amount",GC.Spread.Pivot.PivotTableFieldType.valueField, GC.Pivot.SubtotalType.sum);
8285
8315
  * sourceSheet.setValue(1,3,1000);
8286
8316
  * pivotTable.updateSource();
8317
+ * var newSourceData = [["Salesman","ProductType","Product","Sales"],
8318
+ * ["SunLin","Drinks","Apple Juice",74],
8319
+ * ["JinShiPeng","Drinks","Milk",235],
8320
+ * ["ZhangShang","Dessert","Chocolate",20],
8321
+ * ["SunYang","Dessert","Beef Jerky",125]];
8322
+ * sourceSheet.setArray(10, 0, newSourceData);
8323
+ * sourceSheet.tables.add('newSourceData', 10, 0, 5, 4);
8324
+ * pivotTable.updateSource('newSourceData');
8287
8325
  * ```
8288
8326
  */
8289
- updateSource(): void;
8327
+ updateSource(source?: string): void;
8290
8328
  /**
8291
8329
  * Get or set value filter info for a field.
8292
8330
  * @param {string} fieldName Indicates the target field name of pivot table.
@@ -11134,6 +11172,7 @@ declare module GC{
11134
11172
  filter?: GC.Spread.Report.IFilter;
11135
11173
  sortOptions?: GC.Spread.Report.SortOption[];
11136
11174
  showCollapseButton?: boolean;
11175
+ initialExpansionState?: 'Expanded' | 'Collapsed';
11137
11176
  alias?: string;
11138
11177
  autoExpand?: 'Both' | 'Horizontal' | 'Vertical' | 'None';
11139
11178
  }
@@ -11357,6 +11396,14 @@ declare module GC{
11357
11396
  }
11358
11397
 
11359
11398
 
11399
+ /**
11400
+ * @typedef GC.Spread.Report.ChartCell
11401
+ * @type {{type: 'Chart'; dataChartName: string;chartPreviewVisible: boolean;}}
11402
+ */
11403
+ export type ChartCell =
11404
+ {type: 'Chart'; dataChartName: string; chartPreviewVisible?: boolean;}
11405
+
11406
+
11360
11407
  /**
11361
11408
  * @typedef GC.Spread.Report.ConditionRule
11362
11409
  * @type {{ column: string; operator: GC.Spread.Report.ConditionRuleOperator; } & (GC.Spread.Report.IConditionRuleValueType | GC.Spread.Report.IConditionRuleCellType | GC.Spread.Report.IConditionRuleDataColumnType | GC.Spread.Report.IConditionRuleParameterType | GC.Spread.Report.IConditionRuleFormulaType)}
@@ -11505,10 +11552,10 @@ declare module GC{
11505
11552
 
11506
11553
  /**
11507
11554
  * @typedef GC.Spread.Report.StaticCell
11508
- * @type {{type: 'Static'; pin?: 'None' | 'Row' | 'Column' | 'Both'; autoExpand?: 'Both' | 'Horizontal' | 'Vertical' | 'None'; showCollapseButton?: boolean;}}
11555
+ * @type {{type: 'Static'; pin?: 'None' | 'Row' | 'Column' | 'Both'; autoExpand?: 'Both' | 'Horizontal' | 'Vertical' | 'None'; showCollapseButton?: boolean; initialExpansionState?: 'Expanded' | 'Collapsed';}}
11509
11556
  */
11510
11557
  export type StaticCell =
11511
- {type: 'Static'; pin?: 'None' | 'Row' | 'Column' | 'Both'; autoExpand?: 'Both' | 'Horizontal' | 'Vertical' | 'None'; showCollapseButton?: boolean;}
11558
+ {type: 'Static'; pin?: 'None' | 'Row' | 'Column' | 'Both'; autoExpand?: 'Both' | 'Horizontal' | 'Vertical' | 'None'; showCollapseButton?: boolean; initialExpansionState?: 'Expanded' | 'Collapsed';}
11512
11559
 
11513
11560
 
11514
11561
  /**
@@ -11529,10 +11576,10 @@ declare module GC{
11529
11576
 
11530
11577
  /**
11531
11578
  * @typedef GC.Spread.Report.ReportTemplateCell
11532
- * @type {(GC.Spread.Report.ListCell | GC.Spread.Report.GroupCell | GC.Spread.Report.SummaryCell | GC.Spread.Report.StaticCell) & GC.Spread.Report.ITemplateCellCommonSetting}
11579
+ * @type {(GC.Spread.Report.ListCell | GC.Spread.Report.GroupCell | GC.Spread.Report.SummaryCell | GC.Spread.Report.StaticCell | GC.Spread.Report.ChartCell) & GC.Spread.Report.ITemplateCellCommonSetting}
11533
11580
  */
11534
11581
  export type TemplateCell =
11535
- (GC.Spread.Report.ListCell | GC.Spread.Report.GroupCell | GC.Spread.Report.SummaryCell | GC.Spread.Report.StaticCell) & GC.Spread.Report.ITemplateCellCommonSetting
11582
+ (GC.Spread.Report.ListCell | GC.Spread.Report.GroupCell | GC.Spread.Report.SummaryCell | GC.Spread.Report.StaticCell | GC.Spread.Report.ChartCell) & GC.Spread.Report.ITemplateCellCommonSetting
11536
11583
 
11537
11584
 
11538
11585
  export class ReportSheet{
@@ -12241,6 +12288,8 @@ declare module GC{
12241
12288
  * Toggle the collapse state of the specified cell.
12242
12289
  * @param {number} row The row index.
12243
12290
  * @param {number} col The column index.
12291
+ * @param {'Collapsed' | 'Expanded'} targetState The target state, collapse or expand the specific cell.
12292
+ * @param {boolean} recursive True will update the state of the current cell and all the descendant cells, false will only update the current cell.
12244
12293
  * @example
12245
12294
  * ```
12246
12295
  * const report = spread.addSheetTab(0, "Report", GC.Spread.Sheets.SheetType.reportSheet);
@@ -12334,7 +12383,6 @@ declare module GC{
12334
12383
  /**
12335
12384
  * Represents a TemplateSheet.
12336
12385
  * @class
12337
- * @noInheritDoc
12338
12386
  * @param {string} name The name of the TemplateSheet.
12339
12387
  * @example
12340
12388
  * ```
@@ -12627,12 +12675,21 @@ declare module GC{
12627
12675
  }
12628
12676
 
12629
12677
 
12678
+ export interface ICalendarDateRange{
12679
+ start: Date;
12680
+ end: Date;
12681
+ }
12682
+
12683
+
12630
12684
  export interface ICalendarOption{
12631
12685
  startDay?: GC.Spread.Sheets.CalendarStartDay;
12632
12686
  calendarPage?: GC.Spread.Sheets.CalendarPage;
12633
12687
  showTime?: boolean;
12634
12688
  showDateRange?: boolean;
12635
12689
  showBuiltInDateRange?: boolean;
12690
+ defaultDateTime?: Date | GC.Spread.Sheets.ICalendarDateRange;
12691
+ maxDate?: Date;
12692
+ minDate?: Date;
12636
12693
  }
12637
12694
 
12638
12695
 
@@ -14690,6 +14747,7 @@ declare module GC{
14690
14747
  * @property {boolean} [calcOnDemand] - Whether to calculate formulas only when they are demanded, default false.
14691
14748
  * @property {boolean} [incrementalCalculation] - Whether to incremental calculate formulas without blocking UI, default false.
14692
14749
  * @property {boolean} [includeUnusedStyles] - Whether to include the unused name style when converting excel xml to the json, default true.
14750
+ * @property {boolean} [convertSheetTableToDataTable] - Whether to convert the sheet tables to data manager tables, default false.
14693
14751
  * @property {string} [password] - The password to open the workbook.
14694
14752
  * @property {GC.Spread.Sheets.OpenMode} [openMode] - The open mode of normal, lazy and incremental. By default is normal.
14695
14753
  * @property {GC.Spread.Sheets.ProgressFunctionType} [progress] - The progress callback function for each open mode.
@@ -14705,6 +14763,7 @@ declare module GC{
14705
14763
  calcOnDemand?: boolean;
14706
14764
  incrementalCalculation?: boolean;
14707
14765
  includeUnusedStyles?: boolean;
14766
+ convertSheetTableToDataTable?: boolean;
14708
14767
  password?: string;
14709
14768
  openMode?: GC.Spread.Sheets.OpenMode;
14710
14769
  progress?: GC.Spread.Sheets.ProgressFunctionType;
@@ -16913,7 +16972,7 @@ declare module GC{
16913
16972
  /**
16914
16973
  * Sheet all used range type
16915
16974
  */
16916
- all= 262143,
16975
+ all= 4294967295,
16917
16976
  /**
16918
16977
  * Sheet header used range
16919
16978
  */
@@ -16985,7 +17044,15 @@ declare module GC{
16985
17044
  /**
16986
17045
  * Sheet picture used range
16987
17046
  */
16988
- picture= 131072
17047
+ picture= 131072,
17048
+ /**
17049
+ * Sheet tag used range
17050
+ */
17051
+ tag= 262144,
17052
+ /**
17053
+ * Sheet data range used range
17054
+ */
17055
+ dataRange= 524288
16989
17056
  }
16990
17057
 
16991
17058
  /**
@@ -17157,6 +17224,20 @@ declare module GC{
17157
17224
  * @type {GC.Spread.Sheets.SheetArea}
17158
17225
  */
17159
17226
  sheetArea: GC.Spread.Sheets.SheetArea;
17227
+ /**
17228
+ * Gets or sets whether the cell can enter edit mode for editing.
17229
+ * @param {boolean} [value] Set to `false` to disallow the cell enter edit mode for editing.
17230
+ * @returns {boolean|GC.Spread.Sheets.CellRange} If no value is set, returns whether the cell can enter edit mode for editing; otherwise, returns the cell.
17231
+ * @example
17232
+ * ```
17233
+ * activeSheet.getRange(0, 0, 2, 3, GC.Spread.Sheets.SheetArea.viewport).allowEditInCell(false);
17234
+ * ```
17235
+ * @example
17236
+ * ```
17237
+ * activeSheet.getCell(1,1).allowEditInCell(false);
17238
+ * ```
17239
+ */
17240
+ allowEditInCell(value?: boolean): any;
17160
17241
  /**
17161
17242
  * Gets or sets the alternative text of the cell for screen readers.
17162
17243
  * @param {string} value The alternative text of the cell.
@@ -20373,12 +20454,18 @@ declare module GC{
20373
20454
  * @param eventParam *{@link GC.Spread.Sheets.Tables.Table}* `table` The table which is resizing.
20374
20455
  * @param eventParam *{@link GC.Spread.Sheets.Range}* `oldRange` The table range before resize.
20375
20456
  * @param eventParam *{@link GC.Spread.Sheets.Range}* `newRange` The table range after resize.
20457
+ * @param eventParam *boolean* `cancel` Whether to cancel the current resize behavior. The default value is false.
20376
20458
  * @example
20377
20459
  * ```
20378
20460
  * //This example uses the TableResizing and TableResized event.
20379
20461
  * window.onload = function(){
20380
20462
  * var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
20381
20463
  * var activeSheet = spread.getActiveSheet();
20464
+ * spread.bind(GC.Spread.Sheets.Events.TableResizing, function (e, data) {
20465
+ * if (data.newRange.rowCount > 10) {
20466
+ * args.cancel = true;
20467
+ * }
20468
+ * });
20382
20469
  * spread.bind(GC.Spread.Sheets.Events.TableResizing, function (e, data) {});
20383
20470
  * spread.bind(GC.Spread.Sheets.Events.TableResized, function (e, data) {});
20384
20471
  * }
@@ -21205,6 +21292,17 @@ declare module GC{
21205
21292
  * ```
21206
21293
  */
21207
21294
  constructor(backColor?: string | GC.Spread.Sheets.IPatternFill | GC.Spread.Sheets.IGradientFill | GC.Spread.Sheets.IGradientPathFill, foreColor?: string, hAlign?: GC.Spread.Sheets.HorizontalAlign, vAlign?: GC.Spread.Sheets.VerticalAlign, font?: string, themeFont?: string, formatter?: string | GC.Spread.Formatter.GeneralFormatter, borderLeft?: GC.Spread.Sheets.LineBorder, borderTop?: GC.Spread.Sheets.LineBorder, borderRight?: GC.Spread.Sheets.LineBorder, borderBottom?: GC.Spread.Sheets.LineBorder, locked?: boolean, textIndent?: number, wordWrap?: boolean, showEllipsis?: boolean, shrinkToFit?: boolean, backgroundImage?: string, cellType?: GC.Spread.Sheets.CellTypes.Base, backgroundImageLayout?: GC.Spread.Sheets.ImageLayout, tabStop?: boolean, textDecoration?: GC.Spread.Sheets.TextDecorationType, imeMode?: GC.Spread.Sheets.ImeMode, name?: string, parentName?: string, watermark?: string, cellPadding?: string, labelOptions?: GC.Spread.Sheets.ILabelOptions, quotePrefix?: boolean, diagonalDown?: GC.Spread.Sheets.LineBorder, diagonalUp?: GC.Spread.Sheets.LineBorder, isVerticalText?: boolean, cellButtons?: GC.Spread.Sheets.ICellButton[], dropdown?: GC.Spread.Sheets.IDropdown[], textOrientation?: number, decoration?: GC.Spread.Sheets.TextDecorationType, mask?: GC.Spread.Sheets.IMaskType, fontStyle?: string, fontWeight?: string, fontSize?: string, fontFamily?: string, hidden?: boolean, textDirection?: GC.Spread.Sheets.TextDirectionType);
21295
+ /**
21296
+ * Indicates whether the cell can enter edit mode for editing.
21297
+ * @type {boolean}
21298
+ * @example
21299
+ * ```
21300
+ * //This example sets the allowEditInCell property.
21301
+ * var style = activeSheet.getStyle(1,1,GC.Spread.Sheets.SheetArea.viewport);
21302
+ * style.allowEditInCell = false;
21303
+ * ```
21304
+ */
21305
+ allowEditInCell: boolean | undefined;
21208
21306
  /**
21209
21307
  * Only work for namedStyle, the boolean value indicates whether the alignment formatting applied.
21210
21308
  * @type {boolean}
@@ -22731,6 +22829,11 @@ declare module GC{
22731
22829
  * spread.addSparklineEx(new MySparklineEx('green'));
22732
22830
  */
22733
22831
  addSparklineEx(sparklineEx: GC.Spread.Sheets.Sparklines.SparklineEx): void;
22832
+ /**
22833
+ * Only used in collaboration case, to apply doc's op.
22834
+ * @param {object} changeSet - change set
22835
+ */
22836
+ applyOp(changeSet: Object): void;
22734
22837
  /**
22735
22838
  * Binds an event to the Workbook.
22736
22839
  * @param {string} type The event type.
@@ -22985,6 +23088,11 @@ declare module GC{
22985
23088
  * ```
22986
23089
  */
22987
23090
  fromJSON(workbookData: Object, deserializationOptions?: GC.Spread.Sheets.IDeserializationOptions): Promise<any>;
23091
+ /**
23092
+ * Only used in collaboration case, to restore the snapshot to workbook state.
23093
+ * @param {object} snapshot - snapshot object
23094
+ */
23095
+ fromSnapshot(snapshot: Object): void;
22988
23096
  /**
22989
23097
  * Gets the active sheet.
22990
23098
  * @returns {GC.Spread.Sheets.Worksheet} The active sheet instance.
@@ -23257,6 +23365,11 @@ declare module GC{
23257
23365
  * @returns {HTMLElement|GC.Spread.Sheets.Workbook} If no value is set, returns the next control; otherwise, returns the spreadsheet.
23258
23366
  */
23259
23367
  nextControl(value?: HTMLElement): any;
23368
+ /**
23369
+ * Only used in collaboration case, to watch op
23370
+ * @param {function} opHandler - callback watch op
23371
+ */
23372
+ onOp(onOpHandler: Function): void;
23260
23373
  /**
23261
23374
  * Loads the object state from the sjs zipped file.
23262
23375
  * @param {Blob} file - The zipped spreadsheet data file.
@@ -23568,6 +23681,11 @@ declare module GC{
23568
23681
  * ```
23569
23682
  */
23570
23683
  toJSON(serializationOption?: GC.Spread.Sheets.ISerializationOption): Object;
23684
+ /**
23685
+ * Only used in collaboration case, to save workbook state to snapshot.
23686
+ * @return {object} snapshot - snapshot object
23687
+ */
23688
+ toSnapshot(): Object;
23571
23689
  /**
23572
23690
  * Removes the binding of an event to Workbook.
23573
23691
  * @param {string} type The event type.
@@ -23715,6 +23833,21 @@ declare module GC{
23715
23833
  * ```
23716
23834
  */
23717
23835
  conditionalFormats: ConditionalFormatting.ConditionalFormats;
23836
+ /** The datachart manager.
23837
+ * @type {GC.Spread.Sheets.DataCharts.DataChartManager}
23838
+ * @example
23839
+ * ```
23840
+ * //This example creates a datachart.
23841
+ * var datacharts = sheet.dataCharts;
23842
+ * var datachart = datacharts.add('datachart1', 250, 20, 600, 400, GC.Spread.Sheets.DataCharts.DataChartType.column);
23843
+ * ```
23844
+ */
23845
+ dataCharts: GC.Spread.Sheets.DataCharts.DataChartManager;
23846
+ /**
23847
+ * Data range manager for the sheet.
23848
+ * @type {GC.Spread.Sheets.DataRange.DataRangeManager}
23849
+ */
23850
+ dataRanges: GC.Spread.Sheets.DataRange.DataRangeManager;
23718
23851
  /**
23719
23852
  * Indicates the default row height and column width of the sheet.
23720
23853
  * @type {Object}
@@ -26039,21 +26172,21 @@ declare module GC{
26039
26172
  * ```
26040
26173
  * //This example uses the setHyperlink method.
26041
26174
  * sheet.setHyperlink(0, 2, {
26042
- * url: 'https://www.spreadjs.com',
26043
- * tooltip: 'baidu',
26044
- * linkColor: 'blue',
26045
- * visitedLinkColor: 'red',
26046
- * target: GC.Spread.Sheets.Hyperlink.HyperlinkTargetType.blank,
26047
- * command: 'navigationLeft'
26048
- * }, GC.Spread.Sheets.SheetArea.viewport);
26175
+ * url: 'https://www.spreadjs.com',
26176
+ * tooltip: 'spreadjs',
26177
+ * linkColor: 'blue',
26178
+ * visitedLinkColor: 'red',
26179
+ * target: GC.Spread.Sheets.Hyperlink.HyperlinkTargetType.blank,
26180
+ * command: 'navigationLeft'
26181
+ * });
26182
+ * sheet.setValue(0,2, 'spreadjs');
26049
26183
  * sheet.setHyperlink(1, 1, {
26050
- * url: 'https://www.spreadjs.com',
26051
- * tooltip: 'baidu',
26052
- * setUnderlineToStyle: true;
26053
- * setForeColorToStyle: true;
26054
- * target: GC.Spread.Sheets.Hyperlink.HyperlinkTargetType.top,
26055
- * command: function() { console.log('Only show this message when click the hyperlink.')}
26056
- * }, GC.Spread.Sheets.SheetArea.viewport);
26184
+ * url: 'https://www.spreadjs.com',
26185
+ * tooltip: 'spreadjs',
26186
+ * target: GC.Spread.Sheets.Hyperlink.HyperlinkTargetType.top,
26187
+ * command: function () { console.log('Only show this message when click the hyperlink.') }
26188
+ * });
26189
+ * sheet.setValue(1,1, 'spreadjs');
26057
26190
  * ```
26058
26191
  */
26059
26192
  setHyperlink(row: number, col: number, value: GC.Spread.Sheets.IHyperlink, sheetArea?: GC.Spread.Sheets.SheetArea): void;
@@ -27068,6 +27201,22 @@ declare module GC{
27068
27201
  }
27069
27202
 
27070
27203
 
27204
+ export interface IDataBinding{
27205
+ /**
27206
+ * Represents the data binding source. it can be a table name, or a formula.
27207
+ */
27208
+ dataSource: string;
27209
+ /**
27210
+ * Represents the column name or column index of the data source that will binding to the text of the item of the ComboBox.
27211
+ */
27212
+ text?: string | number;
27213
+ /**
27214
+ * Represents the column name or column index of the data source that will binding to the value of the item of the ComboBox.
27215
+ */
27216
+ value?: string | number;
27217
+ }
27218
+
27219
+
27071
27220
  export interface IFileInfo{
27072
27221
  name: string;
27073
27222
  blob?: Blob;
@@ -27146,6 +27295,29 @@ declare module GC{
27146
27295
  vertical= 1
27147
27296
  }
27148
27297
 
27298
+ /**
27299
+ * Specifies what is the diverge direction of the diagonal cell type
27300
+ * @readonly
27301
+ * @enum {number}
27302
+ * @example
27303
+ * ```
27304
+ * //This example uses the EditorValueType enumeration.
27305
+ * var diagonalCellType = new GC.Spread.Sheets.CellTypes.Diagonal();
27306
+ * diagonalCellType.divergeDirection(GC.Spread.Sheets.CellTypes.DivergeDirection.topLeftToBottomRight)
27307
+ * activeSheet.getCell(2, 2).cellType(diagonalCellType);
27308
+ * ```
27309
+ */
27310
+ export enum DivergeDirection{
27311
+ /**
27312
+ * Represents diverge from the TopLeft to the BottomRight.
27313
+ */
27314
+ topLeftToBottomRight= 0,
27315
+ /**
27316
+ * Represents diverge from the BottomLeft to the TopRight.
27317
+ */
27318
+ bottomLeftToTopRight= 1
27319
+ }
27320
+
27149
27321
  /**
27150
27322
  * Represents the editor type of text cell type.
27151
27323
  * @enum {number}
@@ -28150,6 +28322,28 @@ declare module GC{
28150
28322
  * ```
28151
28323
  */
28152
28324
  allowFloat(value?: boolean): any;
28325
+ /**
28326
+ * Gets or sets the data binding of the ComboBox cell type.
28327
+ * @param {GC.Spread.Sheets.CellTypes.IDataBinding} [value] the data binding of the ComboBox.
28328
+ * @returns {GC.Spread.Sheets.CellTypes.IDataBinding | GC.Spread.Sheets.CellTypes.ComboBox} If no value is set, returns the combo box's data binding; otherwise, returns the combo box cellType.
28329
+ * @example
28330
+ * ```
28331
+ * //This example shows binding a table name to the ComboBox cell type.
28332
+ * var tableName = { dataSource: "productName", text: "productName", value: "productId" };
28333
+ * var cellType = new GC.Spread.Sheets.CellTypes.ComboBox();
28334
+ * cellType.dataBinding(tableName);
28335
+ * activeSheet.getCell(1, 3).cellType(cellType);
28336
+ * ```
28337
+ * @example
28338
+ * ```
28339
+ * //This example shows binding a formula to the ComboBox cell type.
28340
+ * var formula = { dataSource: '=SORT(UNIQUE(QUERY("Products", {"productName","productId"})))', text: 0, value: 1 };
28341
+ * var cellType2 = new GC.Spread.Sheets.CellTypes.ComboBox();
28342
+ * cellType2.dataBinding(formula);
28343
+ * activeSheet.getCell(10, 3).cellType(cellType2);
28344
+ * ```
28345
+ */
28346
+ dataBinding(value?: GC.Spread.Sheets.CellTypes.IDataBinding): GC.Spread.Sheets.CellTypes.IDataBinding | GC.Spread.Sheets.CellTypes.ComboBox;
28153
28347
  /**
28154
28348
  * Gets or sets whether the combo box is editable.
28155
28349
  * @param {boolean} value Whether the combo box is editable.
@@ -28249,6 +28443,47 @@ declare module GC{
28249
28443
  constructor();
28250
28444
  }
28251
28445
 
28446
+ export class Diagonal extends Text{
28447
+ /**
28448
+ * Represents a diagonal lines cell.
28449
+ * @extends GC.Spread.Sheets.CellTypes.Text
28450
+ * @class
28451
+ * @example
28452
+ * ```
28453
+ * //This example creates a diagonal cell.
28454
+ * var diagonalCellType = new GC.Spread.Sheets.CellTypes.Diagonal();
28455
+ * activeSheet.getCell(2, 2).cellType(diagonalCellType).value('Year,Product,Region');
28456
+ * ```
28457
+ */
28458
+ constructor();
28459
+ /**
28460
+ * Gets or sets the diverge direction of the diagonal cell type.
28461
+ * @param {GC.Spread.Sheets.CellTypes.DivergeDirection} value The type of diverge direction.
28462
+ * @returns {GC.Spread.Sheets.CellTypes.DivergeDirection | GC.Spread.Sheets.CellTypes.Diagonal} If no value is set, returns the type of diverge direction; otherwise, returns the diagonal cellType.
28463
+ * @example
28464
+ * ```
28465
+ * //This example gets the diverge direction type.
28466
+ * var cellType = new GC.Spread.Sheets.CellTypes.Diagonal();
28467
+ * activeSheet.getCell(2, 2).cellType(cellType);
28468
+ * alert(cellType.divergeDirection());
28469
+ * ```
28470
+ */
28471
+ divergeDirection(value?: GC.Spread.Sheets.CellTypes.DivergeDirection): GC.Spread.Sheets.CellTypes.DivergeDirection | GC.Spread.Sheets.CellTypes.Diagonal;
28472
+ /**
28473
+ * Gets or sets the line border of the diagonal cell type.
28474
+ * @param {GC.Spread.Sheets.LineBorder} value The type of line border.
28475
+ * @returns {GC.Spread.Sheets.LineBorder | GC.Spread.Sheets.CellTypes.Diagonal} If no value is set, returns the type of line border; otherwise, returns the diagonal cellType.
28476
+ * @example
28477
+ * ```
28478
+ * //This example gets the diverge direction type.
28479
+ * var cellType = new GC.Spread.Sheets.CellTypes.Diagonal();
28480
+ * activeSheet.getCell(2, 2).cellType(cellType);
28481
+ * alert(cellType.lineBorder());
28482
+ * ```
28483
+ */
28484
+ lineBorder(value?: GC.Spread.Sheets.LineBorder): GC.Spread.Sheets.LineBorder | GC.Spread.Sheets.CellTypes.Diagonal;
28485
+ }
28486
+
28252
28487
  export class FileUpload extends Base{
28253
28488
  /**
28254
28489
  * Represents a file upload cell type.
@@ -31111,6 +31346,22 @@ declare module GC{
31111
31346
  * ```
31112
31347
  */
31113
31348
  var cancelInput: { canUndo: boolean, execute(context: GC.Spread.Sheets.Workbook, options: {sheetName: string}): any};
31349
+ /**
31350
+ * Represents the command used to switch the editor status between enter and edit mode when a cell is editing.
31351
+ * @property {boolean} canUndo - indicates whether the command supports undo and redo operations.
31352
+ * @property {function} execute - performs an execute or undo operation.
31353
+ * The arguments of the execute method are as follows.
31354
+ * @param {GC.Spread.Sheets.Workbook} context The context of the operation.
31355
+ * @param {Object} options The options of the operation.
31356
+ * @param {string} options.sheetName The sheet name.
31357
+ * @param {boolean} isUndo `true` if this is an undo operation; otherwise, `false`.
31358
+ * @example
31359
+ * ```
31360
+ * // start editing a cell with invoking command
31361
+ * spread.commandManager().execute({cmd: "changeEditorStatus", sheetName: "Sheet1"});
31362
+ * ```
31363
+ */
31364
+ var changeEditorStatus: { canUndo: boolean, execute(context: GC.Spread.Sheets.Workbook, options: {sheetName: string}): any};
31114
31365
  /**
31115
31366
  * Represents the command used to switch the formula reference between relative, absolute, and mixed when editing formulas.
31116
31367
  * @property {boolean} canUndo - indicates whether the command supports undo and redo operations.
@@ -32601,6 +32852,22 @@ declare module GC{
32601
32852
  * ```
32602
32853
  */
32603
32854
  var splitResizeRow: { canUndo: boolean, execute(context: GC.Spread.Sheets.Workbook, options: { sheetName: string, rows: Object[], size: number, columnHeader: boolean }, isUndo: boolean): any};
32855
+ /**
32856
+ * Represents the command used to start editing the active cell with the edit mode.
32857
+ * @property {boolean} canUndo - indicates whether the command supports undo and redo operations.
32858
+ * @property {function} execute - performs an execute or undo operation.
32859
+ * The arguments of the execute method are as follows.
32860
+ * @param {GC.Spread.Sheets.Workbook} context The context of the operation.
32861
+ * @param {Object} options The options of the operation.
32862
+ * @param {string} options.sheetName The sheet name.
32863
+ * @param {boolean} isUndo `true` if this is an undo operation; otherwise, `false`.
32864
+ * @example
32865
+ * ```
32866
+ * // start editing a cell with invoking command
32867
+ * spread.commandManager().execute({cmd: "startEdit", sheetName: "Sheet1"});
32868
+ * ```
32869
+ */
32870
+ var startEdit: { canUndo: boolean, execute(context: GC.Spread.Sheets.Workbook, options: {sheetName: string}): any};
32604
32871
  /**
32605
32872
  * Represents the command used to delete columns for table.
32606
32873
  * @property {boolean} canUndo - indicates whether the command supports undo and redo operations.
@@ -32695,6 +32962,23 @@ declare module GC{
32695
32962
  * ```
32696
32963
  */
32697
32964
  var tableResize: { canUndo: boolean, execute(context: GC.Spread.Sheets.Workbook, options: {sheetName: string, tableName: string, resizeToRange: GC.Spread.Sheets.Range}, isUndo: boolean): boolean};
32965
+ /**
32966
+ * Represents the command used to submit changes of the tables which bind data manager tables.
32967
+ * @property {boolean} canUndo - indicates whether the command supports undo and redo operations.
32968
+ * @property {function} execute - performs an execute or undo operation.
32969
+ * The arguments of the execute method are as follows.
32970
+ * @param {GC.Spread.Sheets.Workbook} context The context of the operation.
32971
+ * @param {Object} options The options of the operation.
32972
+ * @param {string} [options.sheetName] The sheet name, from active sheet by default.
32973
+ * @param {string[]} [options.tableNames] The table names, from active table by default.
32974
+ * @param {boolean} isUndo `true` if this is an undo operation; otherwise, `false`.
32975
+ * @example
32976
+ * ```
32977
+ * // submit changes of the tables which bind the data manager tables with invoking command
32978
+ * spread.commandManager().execute({cmd: "tableSubmitChanges", sheetName: "Sheet1", tableNames: ["table1"]});
32979
+ * ```
32980
+ */
32981
+ var tableSubmitChanges: { canUndo: boolean, execute(context: GC.Spread.Sheets.Workbook, options: {sheetName?: string, tableNames?: string[] }, isUndo: boolean): boolean};
32698
32982
  /**
32699
32983
  * Represents the command used to perform an undo of the most recent edit or action.
32700
32984
  * @property {boolean} canUndo - indicates whether the command supports undo and redo operations.
@@ -37232,6 +37516,1610 @@ declare module GC{
37232
37516
  }
37233
37517
  }
37234
37518
 
37519
+ module DataCharts{
37520
+
37521
+ export interface IAnimationOption{
37522
+ duration?: number;
37523
+ easing?: GC.Spread.Sheets.DataCharts.AnimationEasing;
37524
+ scale?: number;
37525
+ startDelay?: number;
37526
+ }
37527
+
37528
+
37529
+ export interface IAxisOption{
37530
+ type?: GC.Spread.Sheets.DataCharts.AxisType;
37531
+ labels?: boolean;
37532
+ axisLine?: boolean;
37533
+ reversed?: boolean;
37534
+ title?: string;
37535
+ max?: GC.Spread.Sheets.DataCharts.IValueOption;
37536
+ min?: GC.Spread.Sheets.DataCharts.IValueOption;
37537
+ position?: GC.Spread.Sheets.DataCharts.AxisPosition;
37538
+ origin?: number;
37539
+ format?: GC.Spread.Sheets.DataCharts.IFormatOption;
37540
+ majorUnit?: GC.Spread.Sheets.DataCharts.IAxisUnitOption;
37541
+ overlappingLabels?: GC.Spread.Sheets.DataCharts.OverlappingLabels;
37542
+ dateMode?: GC.Spread.Sheets.DataCharts.DateMode;
37543
+ hoverStyle?: GC.Spread.Sheets.DataCharts.ITextStyleOption;
37544
+ labelAngle?: number[];
37545
+ labelStyle?: GC.Spread.Sheets.DataCharts.ILabelStyleOption;
37546
+ logBase?: number;
37547
+ majorGrid?: boolean;
37548
+ majorTickSize?: number;
37549
+ majorTicks?: GC.Spread.Sheets.DataCharts.TickMark;
37550
+ minorGrid?: boolean;
37551
+ minorTickSize?: number;
37552
+ minorTicks?: GC.Spread.Sheets.DataCharts.TickMark;
37553
+ minorUnit?: GC.Spread.Sheets.DataCharts.IAxisUnitOption;
37554
+ scale?: GC.Spread.Sheets.DataCharts.IValueScaleOption;
37555
+ style?: GC.Spread.Sheets.DataCharts.IStyleOption;
37556
+ titleStyle?: GC.Spread.Sheets.DataCharts.ITitleStyleOption;
37557
+ lineStyle?: GC.Spread.Sheets.DataCharts.ILineStyle;
37558
+ majorGridStyle?: GC.Spread.Sheets.DataCharts.ILineStyle;
37559
+ majorTickStyle?: GC.Spread.Sheets.DataCharts.ILineStyle;
37560
+ minorGridStyle?: GC.Spread.Sheets.DataCharts.ILineStyle;
37561
+ minorTickStyle?: GC.Spread.Sheets.DataCharts.ILineStyle;
37562
+ }
37563
+
37564
+
37565
+ export interface IAxisUnitOption{
37566
+ dateMode?: GC.Spread.Sheets.DataCharts.DateMode;
37567
+ value?: number;
37568
+ }
37569
+
37570
+
37571
+ export interface IBarStyleOption{
37572
+ overlap?: number;
37573
+ width?: number;
37574
+ borderRadius?: GC.Spread.Sheets.DataCharts.IBorderRadius;
37575
+ }
37576
+
37577
+
37578
+ export interface IBorderRadius{
37579
+ bottomLeft?: number;
37580
+ bottomRight?: number;
37581
+ topLeft?: number;
37582
+ topRight?: number;
37583
+ }
37584
+
37585
+
37586
+ export interface ICategoryEncodingOption extends GC.Spread.Sheets.DataCharts.IFieldBasicOption{
37587
+ sort?: GC.Spread.Sheets.DataCharts.ISortEncodingOption;
37588
+ }
37589
+
37590
+
37591
+ export interface IConfigLegendOption{
37592
+ wrapping?: boolean;
37593
+ }
37594
+
37595
+
37596
+ export interface IConfigOption{
37597
+ dvStyle?: GC.Spread.Sheets.DataCharts.IStyleOption;
37598
+ palette?: GC.Spread.Sheets.DataCharts.IPaletteItemOption[];
37599
+ plotAreaLayout?: GC.Spread.Sheets.DataCharts.IPlotAreaLayoutOption;
37600
+ plotAreas?: GC.Spread.Sheets.DataCharts.IPlotAreaOption[];
37601
+ style?: GC.Spread.Sheets.DataCharts.IStyleOption;
37602
+ textStyle?: GC.Spread.Sheets.DataCharts.ITextStyleOption;
37603
+ header?: GC.Spread.Sheets.DataCharts.IHeaderOption;
37604
+ }
37605
+
37606
+
37607
+ export interface IConnectingLineStyle{
37608
+ stroke?: string;
37609
+ strokeWidth?: number;
37610
+ strokeDasharray?: string;
37611
+ firstLineLength?: number;
37612
+ secondLineLength?: number;
37613
+ }
37614
+
37615
+
37616
+ export interface IContentEncodingOption extends GC.Spread.Sheets.DataCharts.IFieldBasicOption{
37617
+ aggregate?: GC.Spread.Sheets.DataCharts.Aggregate;
37618
+ }
37619
+
37620
+
37621
+ export interface ICssColorOptions{
37622
+ type: "CssColor";
37623
+ color?: GC.Spread.Sheets.DataCharts.ColorString;
37624
+ }
37625
+
37626
+
37627
+ export interface IDataChartConfig{
37628
+ plots: GC.Spread.Sheets.DataCharts.IPlotOption[];
37629
+ config?: GC.Spread.Sheets.DataCharts.IConfigOption;
37630
+ tableName?: string;
37631
+ }
37632
+
37633
+
37634
+ export interface IDataPointStyleOption extends GC.Spread.Sheets.DataCharts.IStyleOption{
37635
+ symbol?: GC.Spread.Sheets.DataCharts.ISymbolStyleOption;
37636
+ bar?: GC.Spread.Sheets.DataCharts.IBarStyleOption;
37637
+ }
37638
+
37639
+
37640
+ export interface IFieldBasicOption{
37641
+ field: string;
37642
+ displayName?: string;
37643
+ }
37644
+
37645
+
37646
+ export interface IFormatOption{
37647
+ type?: GC.Spread.Sheets.DataCharts.FormatType;
37648
+ value: string;
37649
+ }
37650
+
37651
+
37652
+ export interface IHeaderOption{
37653
+ title?: string;
37654
+ textStyle?: GC.Spread.Sheets.DataCharts.ITextStyleOption;
37655
+ padding?: GC.Spread.Sheets.DataCharts.IPaddingOption;
37656
+ style?: GC.Spread.Sheets.DataCharts.IStyleOption;
37657
+ }
37658
+
37659
+
37660
+ export interface ILabelStyleOption{
37661
+ color?: string;
37662
+ fontFamily?: string;
37663
+ fontSize?: number;
37664
+ fontStyle?: GC.Spread.Sheets.DataCharts.FontStyle;
37665
+ fontWeight?: string;
37666
+ opacity?: number;
37667
+ overflow?: GC.Spread.Sheets.DataCharts.TextOverflow;
37668
+ padding?: GC.Spread.Sheets.DataCharts.IPaddingOption;
37669
+ }
37670
+
37671
+
37672
+ export interface ILegendOptions{
37673
+ title?: string;
37674
+ type?: GC.Spread.Sheets.DataCharts.LegendType;
37675
+ height?: number;
37676
+ width?: number;
37677
+ position?: GC.Spread.Sheets.DataCharts.LegendPosition;
37678
+ textStyle?: GC.Spread.Sheets.DataCharts.ITextStyleOption;
37679
+ hAlign?: GC.Spread.Sheets.DataCharts.HAlign;
37680
+ vAlign?: GC.Spread.Sheets.DataCharts.VAlign;
37681
+ padding?: GC.Spread.Sheets.DataCharts.IPaddingOption;
37682
+ }
37683
+
37684
+
37685
+ export interface ILineStyle{
37686
+ stroke?: GC.Spread.Sheets.DataCharts.ColorOptions;
37687
+ strokeWidth?: number;
37688
+ strokeDasharray?: string;
37689
+ strokeOpacity?: number;
37690
+ }
37691
+
37692
+
37693
+ export interface IPaddingOption{
37694
+ top?: number;
37695
+ bottom?: number;
37696
+ left?: number;
37697
+ right?: number;
37698
+ }
37699
+
37700
+
37701
+ export interface IPaletteItemOption{
37702
+ color: GC.Spread.Sheets.DataCharts.ColorOptions;
37703
+ }
37704
+
37705
+
37706
+ export interface IPlotAreaLayoutOption{
37707
+ columnWidths?: GC.Spread.Sheets.DataCharts.IValueOption[];
37708
+ rowHeights?: GC.Spread.Sheets.DataCharts.IValueOption[];
37709
+ }
37710
+
37711
+
37712
+ export interface IPlotAreaOption{
37713
+ axes?: GC.Spread.Sheets.DataCharts.IAxisOption[];
37714
+ column?: number;
37715
+ padding?: GC.Spread.Sheets.DataCharts.IPaddingOption;
37716
+ row?: number;
37717
+ textStyle?: GC.Spread.Sheets.DataCharts.ITextStyleOption;
37718
+ legends?: GC.Spread.Sheets.DataCharts.ILegendOptions[];
37719
+ legend?: GC.Spread.Sheets.DataCharts.IConfigLegendOption;
37720
+ }
37721
+
37722
+
37723
+ export interface IPlotConfigOption{
37724
+ hoverStyle?: GC.Spread.Sheets.DataCharts.IDataPointStyleOption;
37725
+ innerRadius?: number;
37726
+ outerRadius?: number;
37727
+ lineAspect?: GC.Spread.Sheets.DataCharts.LineAspect;
37728
+ palette?: string[];
37729
+ startAngle?: number;
37730
+ style?: GC.Spread.Sheets.DataCharts.IDataPointStyleOption;
37731
+ swapAxes?: boolean;
37732
+ sweep?: number;
37733
+ symbols?: boolean;
37734
+ text?: GC.Spread.Sheets.DataCharts.IPlotConfigTextOption[];
37735
+ tooltip?: GC.Spread.Sheets.DataCharts.IPlotConfigTooltipOption[];
37736
+ hoverAnimation?: GC.Spread.Sheets.DataCharts.IAnimationOption;
37737
+ updateAnimation?: GC.Spread.Sheets.DataCharts.IAnimationOption;
37738
+ }
37739
+
37740
+
37741
+ export interface IPlotConfigTextOption{
37742
+ template?: string;
37743
+ format?: GC.Spread.Sheets.DataCharts.IFormatOption;
37744
+ style?: GC.Spread.Sheets.DataCharts.IStyleOption;
37745
+ textStyle?: GC.Spread.Sheets.DataCharts.ITextStyleOption;
37746
+ connectingLineStyle?: GC.Spread.Sheets.DataCharts.IConnectingLineStyle;
37747
+ maxWidth?: number;
37748
+ offset?: number;
37749
+ overlappingLabels?: GC.Spread.Sheets.DataCharts.OverlappingLabels;
37750
+ position?: GC.Spread.Sheets.DataCharts.TextPosition;
37751
+ }
37752
+
37753
+
37754
+ export interface IPlotConfigTooltipOption{
37755
+ style?: GC.Spread.Sheets.DataCharts.IToolTipStyleOption;
37756
+ textStyle?: GC.Spread.Sheets.DataCharts.IToolTipTextStyleOption;
37757
+ }
37758
+
37759
+
37760
+ export interface IPlotEncodingsOption{
37761
+ values?: GC.Spread.Sheets.DataCharts.IValueEncodingOption[];
37762
+ category?: GC.Spread.Sheets.DataCharts.ICategoryEncodingOption;
37763
+ details?: GC.Spread.Sheets.DataCharts.IFieldBasicOption[];
37764
+ color?: GC.Spread.Sheets.DataCharts.IFieldBasicOption;
37765
+ size?: GC.Spread.Sheets.DataCharts.IFieldBasicOption;
37766
+ tooltip?: GC.Spread.Sheets.DataCharts.IContentEncodingOption[];
37767
+ filter?: GC.Spread.Sheets.DataCharts.IFilterOption;
37768
+ }
37769
+
37770
+
37771
+ export interface IPlotOption{
37772
+ type: GC.Spread.Sheets.DataCharts.DataChartType;
37773
+ encodings?: GC.Spread.Sheets.DataCharts.IPlotEncodingsOption;
37774
+ config?: GC.Spread.Sheets.DataCharts.IPlotConfigOption;
37775
+ }
37776
+
37777
+
37778
+ export interface IQuadrangleStyleOption{
37779
+ leftBorder?: GC.Spread.Sheets.DataCharts.ILineStyle;
37780
+ rightBorder?: GC.Spread.Sheets.DataCharts.ILineStyle;
37781
+ topBorder?: GC.Spread.Sheets.DataCharts.ILineStyle;
37782
+ bottomBorder?: GC.Spread.Sheets.DataCharts.ILineStyle;
37783
+ }
37784
+
37785
+
37786
+ export interface ISortEncodingOption{
37787
+ field: string;
37788
+ aggregate?: GC.Spread.Sheets.DataCharts.Aggregate;
37789
+ order?: GC.Spread.Sheets.DataCharts.OrderType;
37790
+ }
37791
+
37792
+
37793
+ export interface IStyleOption{
37794
+ fill?: GC.Spread.Sheets.DataCharts.ColorOptions;
37795
+ fillOpacity?: number;
37796
+ stroke?: GC.Spread.Sheets.DataCharts.ColorOptions;
37797
+ strokeDasharray?: string;
37798
+ strokeOpacity?: number;
37799
+ strokeWidth?: number;
37800
+ }
37801
+
37802
+
37803
+ export interface ISymbolStyleOption{
37804
+ symbolShape?: GC.Spread.Sheets.DataCharts.SymbolShape;
37805
+ symbolSize?: number;
37806
+ }
37807
+
37808
+
37809
+ export interface ITextDecorationOption{
37810
+ lineThrough?: boolean;
37811
+ overline?: boolean;
37812
+ underline?: boolean;
37813
+ }
37814
+
37815
+
37816
+ export interface ITextStyleOption{
37817
+ alignment?: GC.Spread.Sheets.DataCharts.HAlign;
37818
+ color?: string;
37819
+ fontFamily?: string;
37820
+ fontSize?: number;
37821
+ fontStyle?: GC.Spread.Sheets.DataCharts.FontStyle;
37822
+ fontWeight?: string;
37823
+ opacity?: number;
37824
+ overflow?: GC.Spread.Sheets.DataCharts.TextOverflow;
37825
+ }
37826
+
37827
+
37828
+ export interface ITitleStyleOption{
37829
+ color?: string;
37830
+ fontFamily?: string;
37831
+ fontSize?: number;
37832
+ fontStyle?: GC.Spread.Sheets.DataCharts.FontStyle;
37833
+ fontWeight?: string;
37834
+ opacity?: number;
37835
+ padding?: GC.Spread.Sheets.DataCharts.IPaddingOption;
37836
+ }
37837
+
37838
+
37839
+ export interface IToolTipStyleOption{
37840
+ fill?: GC.Spread.Sheets.DataCharts.ColorOptions;
37841
+ stroke?: GC.Spread.Sheets.DataCharts.ColorOptions;
37842
+ strokeWidth?: number;
37843
+ fillOpacity?: number;
37844
+ strokeOpacity?: number;
37845
+ }
37846
+
37847
+
37848
+ export interface IToolTipTextStyleOption{
37849
+ color?: string;
37850
+ fontFamily?: string;
37851
+ fontSize?: number;
37852
+ fontStyle?: GC.Spread.Sheets.DataCharts.FontStyle;
37853
+ fontWeight?: string;
37854
+ opacity?: number;
37855
+ textDecoration?: GC.Spread.Sheets.DataCharts.ITextDecorationOption;
37856
+ }
37857
+
37858
+
37859
+ export interface IValueEncodingOption extends GC.Spread.Sheets.DataCharts.IFieldBasicOption{
37860
+ aggregate?: GC.Spread.Sheets.DataCharts.Aggregate;
37861
+ }
37862
+
37863
+
37864
+ export interface IValueFilter{
37865
+ field: string;
37866
+ operate: GC.Spread.Sheets.DataCharts.ComparisonOperator | GC.Spread.Sheets.DataCharts.StringOperator;
37867
+ value: GC.Spread.Sheets.DataCharts.DataValueType | GC.Spread.Sheets.DataCharts.DataValueType[];
37868
+ excludeMatched?: boolean;
37869
+ ignoreCase?: boolean;
37870
+ }
37871
+
37872
+
37873
+ export interface IValueFilterGroup{
37874
+ conditions: GC.Spread.Sheets.DataCharts.IFilterOption[];
37875
+ operate: GC.Spread.Sheets.DataCharts.LogicalOperation;
37876
+ }
37877
+
37878
+
37879
+ export interface IValueOption{
37880
+ type?: GC.Spread.Sheets.DataCharts.ValueOptionType;
37881
+ value?: number;
37882
+ }
37883
+
37884
+
37885
+ export interface IValueScaleOption{
37886
+ type?: GC.Spread.Sheets.DataCharts.ValueScaleType;
37887
+ }
37888
+
37889
+
37890
+ /**
37891
+ * @typedef GC.Spread.Sheets.DataCharts.ColorOptions
37892
+ * @type {GC.Spread.Sheets.DataCharts.ICssColorOptions}
37893
+ */
37894
+ export type ColorOptions =
37895
+ GC.Spread.Sheets.DataCharts.ICssColorOptions
37896
+
37897
+
37898
+ /**
37899
+ * @typedef GC.Spread.Sheets.DataCharts.ColorString
37900
+ * @type {string}
37901
+ */
37902
+ export type ColorString =
37903
+ string
37904
+
37905
+
37906
+ /**
37907
+ * @typedef GC.Spread.Sheets.DataCharts.DataValueType
37908
+ * @type {number | boolean | Date | string | null}
37909
+ */
37910
+ export type DataValueType =
37911
+ number | boolean | Date | string | null
37912
+
37913
+
37914
+ /**
37915
+ * @typedef GC.Spread.Sheets.DataCharts.IFilterOption
37916
+ * @type {GC.Spread.Sheets.DataCharts.IValueFilter | GC.Spread.Sheets.DataCharts.IValueFilterGroup}
37917
+ */
37918
+ export type IFilterOption =
37919
+ GC.Spread.Sheets.DataCharts.IValueFilter | GC.Spread.Sheets.DataCharts.IValueFilterGroup
37920
+
37921
+ /**
37922
+ * Specifies the datachart plot value Aggregate.
37923
+ * @enum {number}
37924
+ */
37925
+ export enum Aggregate{
37926
+ /**
37927
+ * firstValue
37928
+ */
37929
+ firstValue= 0,
37930
+ /**
37931
+ * sum
37932
+ */
37933
+ sum= 1,
37934
+ /**
37935
+ * count
37936
+ */
37937
+ count= 2,
37938
+ /**
37939
+ * average
37940
+ */
37941
+ average= 3,
37942
+ /**
37943
+ * max
37944
+ */
37945
+ max= 4,
37946
+ /**
37947
+ * min
37948
+ */
37949
+ min= 5,
37950
+ /**
37951
+ * countDistinct
37952
+ */
37953
+ countDistinct= 12
37954
+ }
37955
+
37956
+ /**
37957
+ * Specifies the datachart plot AnimationEasing.
37958
+ * @enum {number}
37959
+ */
37960
+ export enum AnimationEasing{
37961
+ /**
37962
+ * linear
37963
+ */
37964
+ linear= 0,
37965
+ /**
37966
+ * swing
37967
+ */
37968
+ swing= 1,
37969
+ /**
37970
+ * easeInQuad
37971
+ */
37972
+ easeInQuad= 2,
37973
+ /**
37974
+ * easeOutQuad
37975
+ */
37976
+ easeOutQuad= 3,
37977
+ /**
37978
+ * easeInOutQuad
37979
+ */
37980
+ easeInOutQuad= 4,
37981
+ /**
37982
+ * easeInCubic
37983
+ */
37984
+ easeInCubic= 5,
37985
+ /**
37986
+ * easeOutCubic
37987
+ */
37988
+ easeOutCubic= 6,
37989
+ /**
37990
+ * easeInOutCubic
37991
+ */
37992
+ easeInOutCubic= 7,
37993
+ /**
37994
+ * easeInQuart
37995
+ */
37996
+ easeInQuart= 8,
37997
+ /**
37998
+ * easeOutQuart
37999
+ */
38000
+ easeOutQuart= 9,
38001
+ /**
38002
+ * easeInOutQuart
38003
+ */
38004
+ easeInOutQuart= 10,
38005
+ /**
38006
+ * easeInQuint
38007
+ */
38008
+ easeInQuint= 11,
38009
+ /**
38010
+ * easeOutQuint
38011
+ */
38012
+ easeOutQuint= 12,
38013
+ /**
38014
+ * easeInOutQuint
38015
+ */
38016
+ easeInOutQuint= 13,
38017
+ /**
38018
+ * easeInSine
38019
+ */
38020
+ easeInSine= 14,
38021
+ /**
38022
+ * easeOutSine
38023
+ */
38024
+ easeOutSine= 15,
38025
+ /**
38026
+ * easeInOutSine
38027
+ */
38028
+ easeInOutSine= 16,
38029
+ /**
38030
+ * easeInExpo
38031
+ */
38032
+ easeInExpo= 17,
38033
+ /**
38034
+ * easeOutExpo
38035
+ */
38036
+ easeOutExpo= 18,
38037
+ /**
38038
+ * easeInOutExpo
38039
+ */
38040
+ easeInOutExpo= 19,
38041
+ /**
38042
+ * easeInCirc
38043
+ */
38044
+ easeInCirc= 20,
38045
+ /**
38046
+ * easeOutCirc
38047
+ */
38048
+ easeOutCirc= 21,
38049
+ /**
38050
+ * easeInOutCirc
38051
+ */
38052
+ easeInOutCirc= 22,
38053
+ /**
38054
+ * easeInBack
38055
+ */
38056
+ easeInBack= 23,
38057
+ /**
38058
+ * easeOutBack
38059
+ */
38060
+ easeOutBack= 24,
38061
+ /**
38062
+ * easeInOutBack
38063
+ */
38064
+ easeInOutBack= 25,
38065
+ /**
38066
+ * easeInBounce
38067
+ */
38068
+ easeInBounce= 26,
38069
+ /**
38070
+ * easeOutBounce
38071
+ */
38072
+ easeOutBounce= 27,
38073
+ /**
38074
+ * easeInOutBounce
38075
+ */
38076
+ easeInOutBounce= 28,
38077
+ /**
38078
+ * easeInElastic
38079
+ */
38080
+ easeInElastic= 29,
38081
+ /**
38082
+ * easeOutElastic
38083
+ */
38084
+ easeOutElastic= 30,
38085
+ /**
38086
+ * easeInOutElastic
38087
+ */
38088
+ easeInOutElastic= 31
38089
+ }
38090
+
38091
+ /**
38092
+ * Specifies the datachart plot AxisPosition.
38093
+ * @enum {number}
38094
+ */
38095
+ export enum AxisPosition{
38096
+ /**
38097
+ none
38098
+ */
38099
+ none= 0,
38100
+ /**
38101
+ near
38102
+ */
38103
+ near= 1,
38104
+ /**
38105
+ far
38106
+ */
38107
+ far= 2
38108
+ }
38109
+
38110
+ /**
38111
+ * Specifies the datachart plot AxisType.
38112
+ * @enum {string}
38113
+ */
38114
+ export enum AxisType{
38115
+ /**
38116
+ x
38117
+ */
38118
+ x= 0,
38119
+ /**
38120
+ y
38121
+ */
38122
+ y= 1
38123
+ }
38124
+
38125
+ /**
38126
+ * Specifies the datachart filter operator.
38127
+ * @enum {string}
38128
+ */
38129
+ export enum ComparisonOperator{
38130
+ /**
38131
+ in
38132
+ */
38133
+ in= "In",
38134
+ /**
38135
+ equalsTo
38136
+ */
38137
+ equalsTo= "EqualsTo",
38138
+ /**
38139
+ greaterThan
38140
+ */
38141
+ greaterThan= "GreaterThan",
38142
+ /**
38143
+ greaterThanOrEqualsTo
38144
+ */
38145
+ greaterThanOrEqualsTo= "GreaterThanOrEqualsTo",
38146
+ /**
38147
+ lessThan
38148
+ */
38149
+ lessThan= "LessThan",
38150
+ /**
38151
+ lessThanOrEqualsTo
38152
+ */
38153
+ lessThanOrEqualsTo= "LessThanOrEqualsTo",
38154
+ /**
38155
+ notEqualsTo
38156
+ */
38157
+ notEqualsTo= "NotEqualsTo"
38158
+ }
38159
+
38160
+ /**
38161
+ * Specifies the datachart type.
38162
+ * @enum {string}
38163
+ */
38164
+ export enum DataChartType{
38165
+ /**
38166
+ * Identifies the current DataChart type as column
38167
+ */
38168
+ column= "Column",
38169
+ /**
38170
+ * Identifies the current DataChart type as rangeColumn
38171
+ */
38172
+ rangeColumn= "RangeColumn",
38173
+ /**
38174
+ * Identifies the current DataChart type as stackedColumn
38175
+ */
38176
+ stackedColumn= "StackedColumn",
38177
+ /**
38178
+ * Identifies the current DataChart type as percentStackedColumn
38179
+ */
38180
+ percentStackedColumn= "PercentStackedColumn",
38181
+ /**
38182
+ * Identifies the current DataChart type as bar
38183
+ */
38184
+ bar= "Bar",
38185
+ /**
38186
+ * Identifies the current DataChart type as rangeBar
38187
+ */
38188
+ rangeBar= "RangeBar",
38189
+ /**
38190
+ * Identifies the current DataChart type as stackedBar
38191
+ */
38192
+ stackedBar= "StackedBar",
38193
+ /**
38194
+ * Identifies the current DataChart type as percentStackedBar
38195
+ */
38196
+ percentStackedBar= "PercentStackedBar",
38197
+ /**
38198
+ * Identifies the current DataChart type as area
38199
+ */
38200
+ area= "Area",
38201
+ /**
38202
+ * Identifies the current DataChart type as rangeArea
38203
+ */
38204
+ rangeArea= "RangeArea",
38205
+ /**
38206
+ * Identifies the current DataChart type as stackedArea
38207
+ */
38208
+ stackedArea= "StackedArea",
38209
+ /**
38210
+ * Identifies the current DataChart type as percentStackedArea
38211
+ */
38212
+ percentStackedArea= "PercentStackedArea",
38213
+ /**
38214
+ * Identifies the current DataChart type as line
38215
+ */
38216
+ line= "Line",
38217
+ /**
38218
+ * Identifies the current DataChart type as pie
38219
+ */
38220
+ pie= "Pie",
38221
+ /**
38222
+ * Identifies the current DataChart type as donut
38223
+ */
38224
+ donut= "Donut",
38225
+ /**
38226
+ * Identifies the current DataChart type as rose
38227
+ */
38228
+ rose= "Rose",
38229
+ /**
38230
+ * Identifies the current DataChart type as radialStackedBar
38231
+ */
38232
+ radialStackedBar= "RadialStackedBar",
38233
+ /**
38234
+ * Identifies the current DataChart type as sunburst
38235
+ */
38236
+ sunburst= "Sunburst",
38237
+ /**
38238
+ * Identifies the current DataChart type as polarCoordinatesBar
38239
+ */
38240
+ polarCoordinatesBar= "PolarCoordinatesBar",
38241
+ /**
38242
+ * Identifies the current DataChart type as polarCoordinatesStackedBar
38243
+ */
38244
+ polarCoordinatesStackedBar= "PolarCoordinatesStackedBar",
38245
+ /**
38246
+ * Identifies the current DataChart type as radar
38247
+ */
38248
+ radar= "Radar",
38249
+ /**
38250
+ * Identifies the current DataChart type as filledRadar
38251
+ */
38252
+ filledRadar= "FilledRadar",
38253
+ /**
38254
+ * Identifies the current DataChart type as scatter
38255
+ */
38256
+ scatter= "Scatter",
38257
+ /**
38258
+ * Identifies the current DataChart type as bubble
38259
+ */
38260
+ bubble= "Bubble"
38261
+ }
38262
+
38263
+ /**
38264
+ * Specifies the datachart plot DateMode.
38265
+ * @enum {string}
38266
+ */
38267
+ export enum DateMode{
38268
+ /**
38269
+ milliSecond
38270
+ */
38271
+ milliSecond= 0,
38272
+ /**
38273
+ second
38274
+ */
38275
+ second= 1,
38276
+ /**
38277
+ minute
38278
+ */
38279
+ minute= 2,
38280
+ /**
38281
+ hour
38282
+ */
38283
+ hour= 3,
38284
+ /**
38285
+ day
38286
+ */
38287
+ day= 4,
38288
+ /**
38289
+ week
38290
+ */
38291
+ week= 5,
38292
+ /**
38293
+ month
38294
+ */
38295
+ month= 6,
38296
+ /**
38297
+ year
38298
+ */
38299
+ year= 7
38300
+ }
38301
+
38302
+ /**
38303
+ * Specifies the datachart plot FontStyle.
38304
+ * @enum {string}
38305
+ */
38306
+ export enum FontStyle{
38307
+ /**
38308
+ normal
38309
+ */
38310
+ normal= "Normal",
38311
+ /**
38312
+ italic
38313
+ */
38314
+ italic= "Italic"
38315
+ }
38316
+
38317
+ /**
38318
+ * Specifies the datachart data level.
38319
+ * @enum {string}
38320
+ */
38321
+ export enum FormatType{
38322
+ /**
38323
+ hundreds
38324
+ */
38325
+ hundreds= "Hundreds",
38326
+ /**
38327
+ thousands
38328
+ */
38329
+ thousands= "Thousands",
38330
+ /**
38331
+ tenThousand
38332
+ */
38333
+ tenThousand= "10000",
38334
+ /**
38335
+ hundredThousand
38336
+ */
38337
+ hundredThousand= "100000",
38338
+ /**
38339
+ millions
38340
+ */
38341
+ millions= "Millions",
38342
+ /**
38343
+ tenMillion
38344
+ */
38345
+ tenMillion= "10000000",
38346
+ /**
38347
+ hundredMillion
38348
+ */
38349
+ hundredMillion= "100000000",
38350
+ /**
38351
+ billions
38352
+ */
38353
+ billions= "Billions",
38354
+ /**
38355
+ trillions
38356
+ */
38357
+ trillions= "Trillions"
38358
+ }
38359
+
38360
+ /**
38361
+ * Specifies the datachart plot HAlign.
38362
+ * @enum {string}
38363
+ */
38364
+ export enum HAlign{
38365
+ /**
38366
+ center
38367
+ */
38368
+ center= "Center",
38369
+ /**
38370
+ left
38371
+ */
38372
+ left= "Left",
38373
+ /**
38374
+ right
38375
+ */
38376
+ right= "Right"
38377
+ }
38378
+
38379
+ /**
38380
+ * Specifies the datachart plot LegendPosition.
38381
+ * @enum {string}
38382
+ */
38383
+ export enum LegendPosition{
38384
+ /**
38385
+ none
38386
+ */
38387
+ none= "None",
38388
+ /**
38389
+ bottom
38390
+ */
38391
+ bottom= "Bottom",
38392
+ /**
38393
+ left
38394
+ */
38395
+ left= "Left",
38396
+ /**
38397
+ right
38398
+ */
38399
+ right= "Right",
38400
+ /**
38401
+ top
38402
+ */
38403
+ top= "Top"
38404
+ }
38405
+
38406
+ /**
38407
+ * Specifies the datachart plot LegendType.
38408
+ * @enum {string}
38409
+ */
38410
+ export enum LegendType{
38411
+ /**
38412
+ color
38413
+ */
38414
+ color= "Color",
38415
+ /**
38416
+ size
38417
+ */
38418
+ size= "Size"
38419
+ }
38420
+
38421
+ /**
38422
+ * Describes the type of lines in the Area chart.
38423
+ * @enum {string}
38424
+ */
38425
+ export enum LineAspect{
38426
+ /**
38427
+ * default
38428
+ */
38429
+ default= "Default",
38430
+ /**
38431
+ * spline
38432
+ */
38433
+ spline= "Spline",
38434
+ /**
38435
+ * stepCenter
38436
+ */
38437
+ stepCenter= "StepCenter"
38438
+ }
38439
+
38440
+ /**
38441
+ * Specifies the datachart string filter logical operator.
38442
+ * @enum {string}
38443
+ */
38444
+ export enum LogicalOperation{
38445
+ /**
38446
+ and
38447
+ */
38448
+ and= "AND",
38449
+ /**
38450
+ or
38451
+ */
38452
+ or= "OR"
38453
+ }
38454
+
38455
+ /**
38456
+ * Specifies the datachart order type.
38457
+ * @enum {string}
38458
+ */
38459
+ export enum OrderType{
38460
+ /**
38461
+ * ascending
38462
+ */
38463
+ ascending= "Ascending",
38464
+ /**
38465
+ * descending
38466
+ */
38467
+ descending= "Descending",
38468
+ /**
38469
+ * none
38470
+ */
38471
+ none= "None"
38472
+ }
38473
+
38474
+ /**
38475
+ * Specifies the datachart plot OverlappingLabels.
38476
+ * @enum {string}
38477
+ */
38478
+ export enum OverlappingLabels{
38479
+ /**
38480
+ * show
38481
+ */
38482
+ show= "Show",
38483
+ /**
38484
+ * hide
38485
+ */
38486
+ hide= "Hide"
38487
+ }
38488
+
38489
+ /**
38490
+ * Specifies the datachart string filter operator.
38491
+ * @enum {string}
38492
+ */
38493
+ export enum StringOperator{
38494
+ /**
38495
+ in
38496
+ */
38497
+ in= "In",
38498
+ /**
38499
+ equalsTo
38500
+ */
38501
+ equalsTo= "EqualsTo",
38502
+ /**
38503
+ contains
38504
+ */
38505
+ contains= "Contains",
38506
+ /**
38507
+ startsWith
38508
+ */
38509
+ startsWith= "StartsWith",
38510
+ /**
38511
+ endsWith
38512
+ */
38513
+ endsWith= "EndsWith"
38514
+ }
38515
+
38516
+ /**
38517
+ * Specifies the datachart SymbolShape.
38518
+ * @enum {number}
38519
+ */
38520
+ export enum SymbolShape{
38521
+ /**
38522
+ * dot
38523
+ */
38524
+ dot= "Dot",
38525
+ /**
38526
+ * box
38527
+ */
38528
+ box= "Box",
38529
+ /**
38530
+ * diamond
38531
+ */
38532
+ diamond= "Diamond",
38533
+ /**
38534
+ * triangle
38535
+ */
38536
+ triangle= "Triangle",
38537
+ /**
38538
+ * x
38539
+ */
38540
+ x= "X",
38541
+ /**
38542
+ * plus
38543
+ */
38544
+ plus= "Plus"
38545
+ }
38546
+
38547
+ /**
38548
+ * Specifies the datachart plot TextOverflow.
38549
+ * @enum {string}
38550
+ */
38551
+ export enum TextOverflow{
38552
+ /**
38553
+ * clip
38554
+ */
38555
+ clip= "Clip",
38556
+ /**
38557
+ * ellipsis
38558
+ */
38559
+ ellipsis= "Ellipsis",
38560
+ /**
38561
+ * wrap
38562
+ */
38563
+ wrap= "Wrap"
38564
+ }
38565
+
38566
+ /**
38567
+ * Specifies the datachart plot TextPosition.
38568
+ * @enum {string}
38569
+ */
38570
+ export enum TextPosition{
38571
+ /**
38572
+ * center
38573
+ */
38574
+ center= "Center",
38575
+ /**
38576
+ * inside
38577
+ */
38578
+ inside= "Inside",
38579
+ /**
38580
+ * outside
38581
+ */
38582
+ outside= "Outside"
38583
+ }
38584
+
38585
+ /**
38586
+ * Specifies the datachart plot TickMark.
38587
+ * @enum {string}
38588
+ */
38589
+ export enum TickMark{
38590
+ /**
38591
+ cross
38592
+ */
38593
+ cross= "Cross",
38594
+ /**
38595
+ inside
38596
+ */
38597
+ inside= "Inside",
38598
+ /**
38599
+ none
38600
+ */
38601
+ none= "None",
38602
+ /**
38603
+ outside
38604
+ */
38605
+ outside= "Outside"
38606
+ }
38607
+
38608
+ /**
38609
+ * Specifies the datachart plot VAlign.
38610
+ * @enum {string}
38611
+ */
38612
+ export enum VAlign{
38613
+ /**
38614
+ top
38615
+ */
38616
+ top= "Top",
38617
+ /**
38618
+ bottom
38619
+ */
38620
+ bottom= "Bottom",
38621
+ /**
38622
+ middle
38623
+ */
38624
+ middle= "Middle"
38625
+ }
38626
+
38627
+ /**
38628
+ * Specifies the datachart plot Orientation.
38629
+ * @enum {string}
38630
+ */
38631
+ export enum ValueOptionType{
38632
+ /**
38633
+ number
38634
+ */
38635
+ number= 0,
38636
+ /**
38637
+ date
38638
+ */
38639
+ date= 1
38640
+ }
38641
+
38642
+ /**
38643
+ * Specifies the datachart plot ValueScaleType.
38644
+ * @enum {string}
38645
+ */
38646
+ export enum ValueScaleType{
38647
+ /**
38648
+ date
38649
+ */
38650
+ date= "Date",
38651
+ /**
38652
+ linear
38653
+ */
38654
+ linear= "Linear"
38655
+ }
38656
+
38657
+
38658
+ export class DataChart{
38659
+ /**
38660
+ * Represents a datachart.
38661
+ * @class
38662
+ * @param {GC.Spread.Sheets.Worksheet} sheet The host sheet of the datachart.
38663
+ * @param {string} name The name of the datachart.
38664
+ * @param {number} x The <i>x</i> location of the datachart.
38665
+ * @param {number} y The <i>y</i> location of the datachart.
38666
+ * @param {number} width The width of the datachart.
38667
+ * @param {number} height The height of the datachart.
38668
+ * @param {GC.Spread.Sheets.DataCharts.DataChartType} type The type of the datachart.
38669
+ */
38670
+ constructor(sheet: GC.Spread.Sheets.Worksheet, name: string, x: number, y: number, width: number, height: number, type: GC.Spread.Sheets.DataCharts.DataChartType);
38671
+ /**
38672
+ * Gets or sets whether to disable moving the data chart.
38673
+ * @param {boolean} value The setting for whether to disable moving the data chart.
38674
+ * @returns {boolean | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the setting for whether to disable moving the data chart; otherwise, returns the data chart.
38675
+ */
38676
+ allowMove(value?: boolean): any;
38677
+ /**
38678
+ * Gets or sets whether to disable resizing the data chart.
38679
+ * @param {boolean} value The setting for whether to disable resizing the data chart.
38680
+ * @returns {boolean | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the setting for whether to disable resizing the data chart; otherwise, returns the data chart.
38681
+ */
38682
+ allowResize(value?: boolean): any;
38683
+ /**
38684
+ * Gets or sets the alternative text of the data chart for screen readers.
38685
+ * @param {string} value The alternative text of the data chart.
38686
+ * @returns {string} The alternative text of the data chart.
38687
+ */
38688
+ alt(value?: string): any;
38689
+ /**
38690
+ * Gets or sets whether this data chart is printable.
38691
+ * @param {boolean} value The value that indicates whether this data chart is printable.
38692
+ * @returns {boolean | void} If no value is set, returns whether this data chart is printable.
38693
+ */
38694
+ canPrint(value?: boolean): any;
38695
+ /**
38696
+ * Gets or sets whether the object moves when hiding or showing, resizing, or moving rows or columns.
38697
+ * @param {boolean} value The value indicates whether the object moves when hiding or showing, resizing, or moving rows or columns.
38698
+ * @returns {boolean | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns whether this data chart dynamically moves; otherwise, returns the data chart.
38699
+ */
38700
+ dynamicMove(value?: boolean): any;
38701
+ /**
38702
+ * Gets or sets whether the position of the data chart is fixed. When fixedPosition is true, dynamicMove and dynamicSize are disabled.
38703
+ * @param {boolean} value The value indicates whether the position of the data chart is fixed.
38704
+ * @returns {boolean | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns whether the position of the data chart is fixed; otherwise, returns the data chart.
38705
+ */
38706
+ dynamicSize(value?: boolean): any;
38707
+ /**
38708
+ * Gets or sets the end column index of the data chart position.
38709
+ * @param {number} value The end column index of the data chart position.
38710
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the end column index of the data chart position; otherwise, returns the data chart.
38711
+ */
38712
+ endColumn(value?: number): any;
38713
+ /**
38714
+ * Gets or sets the offset relative to the end column of the data chart.
38715
+ * @param {number} value The offset relative to the end column of the data chart.
38716
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the offset relative to the end column of the data chart; otherwise, returns the data chart.
38717
+ */
38718
+ endColumnOffset(value?: number): any;
38719
+ /**
38720
+ * Gets or sets the end row index of the data chart position.
38721
+ * @param {number} value The end row index of the data chart position.
38722
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the end row index of the data chart position; otherwise, returns the data chart.
38723
+ */
38724
+ endRow(value?: number): any;
38725
+ /**
38726
+ * Gets or sets the offset relative to the end row of the data chart.
38727
+ * @param {number} value The offset relative to the end row of the data chart.
38728
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the offset relative to the end row of the data chart; otherwise, returns the data chart.
38729
+ */
38730
+ endRowOffset(value?: number): any;
38731
+ /**
38732
+ * get datachart config.
38733
+ * @return {object} The config of the datachart.
38734
+ * @example
38735
+ * ```
38736
+ * var datachart = activeSheet.datacharts.add('datachart1', 250, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.column);
38737
+ * console.log(datachart.getChartConfig());
38738
+ * ```
38739
+ */
38740
+ getChartConfig(): GC.Spread.Sheets.DataCharts.IDataChartConfig;
38741
+ /**
38742
+ * Gets or sets the height of a data chart.
38743
+ * @param {number} value The height of a data chart.
38744
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the height of a data chart; otherwise, returns the data chart.
38745
+ */
38746
+ height(value?: number): any;
38747
+ /**
38748
+ * Gets or sets whether this data chart is locked.
38749
+ * @param {boolean} value The value that indicates whether this data chart is locked.
38750
+ * @returns {boolean | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns whether this data chart is locked; otherwise, returns the data chart.
38751
+ */
38752
+ isLocked(value?: boolean): any;
38753
+ /**
38754
+ * Gets or sets whether this data chart is selected.
38755
+ * @param {boolean} value The value that indicates whether this data chart is selected.
38756
+ * @returns {boolean | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns whether this data chart is selected; otherwise, returns the data chart.
38757
+ */
38758
+ isSelected(value?: boolean): any;
38759
+ /**
38760
+ * Gets or sets whether this data chart is visible.
38761
+ * @param {boolean} value The value that indicates whether this data chart is visible.
38762
+ * @returns {boolean | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns whether this data chart is visible; otherwise, returns the data chart.
38763
+ */
38764
+ isVisible(value?: boolean): any;
38765
+ /**
38766
+ * Gets the name of the data chart.
38767
+ * @param {string} value The name of the data chart.
38768
+ * @returns {string | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the name of the data chart; otherwise, returns the data chart.
38769
+ */
38770
+ name(value?: string): any;
38771
+ /**
38772
+ * set datachart config.
38773
+ * @param {object} config The config of the datachart.
38774
+ * @example
38775
+ * ```
38776
+ * var datachart = activeSheet.datacharts.add('datachart1', 250, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.column);
38777
+ * var config = datachart.getChartConfig();
38778
+ * config.plots[0].type = GC.Spread.Sheets.DataCharts.DataChartType.line;
38779
+ * datachart.setChartConfig(config);
38780
+ * ```
38781
+ */
38782
+ setChartConfig(config: GC.Spread.Sheets.DataCharts.IDataChartConfig): void;
38783
+ /**
38784
+ * Gets or sets the starting column index of the data chart position.
38785
+ * @param {number} value The starting column index of the data chart position.
38786
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the starting column index of the data chart position; otherwise, returns the data chart.
38787
+ */
38788
+ startColumn(value?: number): any;
38789
+ /**
38790
+ * Gets or sets the offset relative to the start column of the data chart.
38791
+ * @param {number} value The offset relative to the start column of the data chart.
38792
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the offset relative to the start column of the data chart; otherwise, returns the data chart.
38793
+ */
38794
+ startColumnOffset(value?: number): any;
38795
+ /**
38796
+ * Gets or sets the starting row index of the data chart position.
38797
+ * @param {number} value The starting row index of the data chart position.
38798
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the starting row index of the data chart position; otherwise, returns the data chart.
38799
+ */
38800
+ startRow(value?: number): any;
38801
+ /**
38802
+ * Gets or sets the offset relative to the start row of the data chart.
38803
+ * @param {number} value The offset relative to the start row of the data chart.
38804
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the offset relative to the start row of the data chart; otherwise, returns the data chart.
38805
+ */
38806
+ startRowOffset(value?: number): any;
38807
+ /**
38808
+ * Gets or sets the width of a data chart.
38809
+ * @param {number} value The width of a data chart.
38810
+ * @returns {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the width of a data chart; otherwise, returns the data chart.
38811
+ */
38812
+ width(value?: number): any;
38813
+ /**
38814
+ * Gets or sets the horizontal location of the data chart.
38815
+ * @param {number} value The horizontal location of the data chart.
38816
+ * @return {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the horizontal location of the data chart; otherwise, returns the data chart.
38817
+ */
38818
+ x(value?: number): any;
38819
+ /**
38820
+ * Gets or sets the vertical location of the data chart.
38821
+ * @param {number} value The vertical location of the data chart.
38822
+ * @return {number | GC.Spread.Sheets.DataCharts.DataChart} If no value is set, returns the vertical location of the data chart; otherwise, returns the data chart.
38823
+ */
38824
+ y(value?: number): any;
38825
+ }
38826
+
38827
+ export class DataChartConfigPanel{
38828
+ /**
38829
+ * Represents a data chart config panel.
38830
+ * @class
38831
+ * @param {HTMLElement | string} host The host element or the host element id or the host element selector.
38832
+ * @param {object} spread The spread that the panel attach to.
38833
+ */
38834
+ constructor(host: HTMLElement | string, spread: GC.Spread.Sheets.Workbook);
38835
+ /**
38836
+ * attach the spread to the config panel.
38837
+ * @example
38838
+ * ```
38839
+ * configPanel.attach(spread);
38840
+ * ```
38841
+ */
38842
+ attach(spread: GC.Spread.Sheets.Workbook): void;
38843
+ /**
38844
+ * destroy the config panel.
38845
+ * @example
38846
+ * ```
38847
+ * configPanel.destroy();
38848
+ * ```
38849
+ */
38850
+ destroy(): void;
38851
+ /**
38852
+ * detach the spread from the config panel.
38853
+ * @example
38854
+ * ```
38855
+ * configPanel.detach();
38856
+ * ```
38857
+ */
38858
+ detach(): void;
38859
+ /**
38860
+ * Gets the DataChartConfigPanel instance by the host element.
38861
+ * @param {HTMLElement|string} host The host element or the host element id or the host element selector.
38862
+ * @returns {GC.Spread.Sheets.DataCharts.DataChartConfigPanel} The DataChartConfigPanel instance.
38863
+ * @example
38864
+ * ```
38865
+ * const configPanel = GC.Spread.Sheets.DataCharts.DataChartConfigPanel.findControl('host');
38866
+ * ```
38867
+ */
38868
+ static findControl(host: HTMLElement|string): GC.Spread.Sheets.DataCharts.DataChartConfigPanel;
38869
+ }
38870
+
38871
+ export class DataChartManager{
38872
+ /**
38873
+ * Represents a datachart manager that managers all datacharts in a sheet.
38874
+ * @class
38875
+ * @param {GC.Spread.Sheets.Worksheet} sheet The worksheet.
38876
+ */
38877
+ constructor();
38878
+ /**
38879
+ * Adds a datachart to the sheet.
38880
+ * @param {string} name The name of the datachart that will be added to the sheet.
38881
+ * @param {number} x The x location of the datachart.
38882
+ * @param {number} y The y location of the datachart.
38883
+ * @param {number} width The width of the datachart.
38884
+ * @param {number} height The height of the datachart.
38885
+ * @param {GC.Spread.Sheets.DataCharts.DataChartType} type The type of the datachart.
38886
+ * @return {GC.Spread.Sheets.DataCharts.DataChart} The datachart that has been added to the sheet.
38887
+ * @example
38888
+ * ```
38889
+ * //This example shows how to add a datachart.
38890
+ * var datachart = activeSheet.datacharts.add('datachart1', 250, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.column);
38891
+ * ```
38892
+ */
38893
+ add(name: string, x: number, y: number, width: number, height: number, type: GC.Spread.Sheets.DataCharts.DataChartType): GC.Spread.Sheets.DataCharts.DataChart;
38894
+ /**
38895
+ * get all data charts.
38896
+ * @return {GC.Spread.Sheets.DataCharts.DataChart[]} get all data charts.
38897
+ * @example
38898
+ * ```
38899
+ * activeSheet.datacharts.add('DataChart1', 0, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.column);
38900
+ * activeSheet.datacharts.add('DataChart2', 500, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.pie);
38901
+ * var dataCharts = activeSheet.datacharts.all();
38902
+ * for (var i = 0; i &lt; dataCharts.length; i++) {
38903
+ * alert("Name of dataChart " + i + " is: " + dataCharts[i].name())
38904
+ * }
38905
+ * ```
38906
+ */
38907
+ all(): GC.Spread.Sheets.DataCharts.DataChart[];
38908
+ /**
38909
+ * remove all data charts.
38910
+ */
38911
+ clear(): void;
38912
+ /**
38913
+ * get a data charts by name.
38914
+ * @param {string} name data chart name.
38915
+ * @return {GC.Spread.Sheets.DataCharts.DataChart} get a data charts by name.
38916
+ * @example
38917
+ * ```
38918
+ * activeSheet.datacharts.add('DataChart1', 0, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.column);
38919
+ * //button
38920
+ * $("#button1").click(function () {
38921
+ * var dataChart = activeSheet.datacharts.get("DataChart1");
38922
+ * });
38923
+ * ```
38924
+ */
38925
+ get(name: string): GC.Spread.Sheets.DataCharts.DataChart;
38926
+ /**
38927
+ * remove a data charts by name.
38928
+ * @param {string} name data chart name.
38929
+ * @example
38930
+ * ```
38931
+ * activeSheet.datacharts.add('DataChart1', 0, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.column);
38932
+ * //button
38933
+ * $("#button1").click(function () {
38934
+ * activeSheet.resumePaint();
38935
+ * activeSheet.datacharts.remove("DataChart1");
38936
+ * activeSheet.repaint();
38937
+ * });
38938
+ * ```
38939
+ */
38940
+ remove(name: string): void;
38941
+ /**
38942
+ * Gets or sets the z-index of chart.
38943
+ * @param {string} name The name of the chart.
38944
+ * @param {number} zIndex The z-index of the chart.
38945
+ * @return {number | *} If the parameter 'zIndex' is null or undefined,it will return the z-index of the chart with the indicate name.
38946
+ * @example
38947
+ * ```
38948
+ * activeSheet.datacharts.add('DataChart1', 200, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.column);
38949
+ * activeSheet.datacharts.add('DataChart2', 0, 20, 480, 300, GC.Spread.Sheets.DataCharts.DataChartType.pie);
38950
+ * activeSheet.datacharts.zIndex('DataChart1', 897);
38951
+ * activeSheet.datacharts.zIndex('DataChart2', 890);
38952
+ * ```
38953
+ */
38954
+ zIndex(name: string, zIndex?: number): any;
38955
+ }
38956
+ }
38957
+
38958
+ module DataRange{
38959
+
38960
+ export interface IDataProvider{
38961
+ /**
38962
+ * The data provider host.
38963
+ */
38964
+ host: GC.Spread.Sheets.DataRange.DataRange;
38965
+ /**
38966
+ * Implement this hook to provide values to data range cells. The `row` and `col` parameters are based on the data range axis. If returns `undefined`, it means fail to get value from data provider, so it will continue to get the value from sheet model.
38967
+ */
38968
+ getValue?: (row: number, col: number) => unknown;
38969
+ /**
38970
+ * Implement this hook to receive the changed values from data range. The `row` and `col` parameters are based on the data range axis. Post your change into `changes` parameter if you want undo/redo. If returns `true`, it means set value successfully to data provider, so it will prevent to set the value to sheet model.
38971
+ */
38972
+ setValue?: (row: number, col: number, value: unknown, changes: any[]) => boolean;
38973
+ /**
38974
+ * Implement this hook to provide styles to data range cells. The `row` and `col` parameters are based on the data range axis. It should return the style as `GC.Spread.Sheets.Style`, otherwise, means fail to get style from data provider, so it will continue to get the style from sheet model.
38975
+ */
38976
+ getStyle?: (row: number, col: number) => GC.Spread.Sheets.Style;
38977
+ /**
38978
+ * Implement this hook to provide spans to data range cells. The `row`, `col`, `rowCount` and `colCount` parameters are based on the data range axis.
38979
+ */
38980
+ getSpans?: (row: number, col: number, rowCount: number, colCount: number) => GC.Spread.Sheets.Range[];
38981
+ /**
38982
+ * Implement this hook to receive changed rows information. The `row` and `rowCount` parameters are based on the data range axis. Post your change into `changes` parameter if you want undo/redo.
38983
+ */
38984
+ onRowChange?: (row: number, rowCount: number, changeType: "add" | "delete", changes: any[]) => void;
38985
+ /**
38986
+ * Implement this hook to receive changed columns information. The `col` and `colCount` parameters are based on the data range axis. Post your change into `changes` parameter if you want undo/redo.
38987
+ */
38988
+ onColumnChange?: (col: number, colCount: number, changeType: "add" | "delete", changes: any[]) => void;
38989
+ /**
38990
+ * Implement this hook to handle the copy action. Input parameter `name` is copied data range name, need to return a different new data range `name` and a data provider instance. Return `false` means prevent to copy data range. Default is `false`.
38991
+ */
38992
+ onCopy?: (name: string) => {name: string, dataProvider: GC.Spread.Sheets.DataRange.IDataProvider} | boolean;
38993
+ /**
38994
+ * Implement this hook to handle the clear contents action. Return `false` means prevent to clear data range contents. Default is `false`.
38995
+ */
38996
+ onClear?: (row: number, col: number, rowCount: number, colCount: number, changes: any[]) => boolean;
38997
+ /**
38998
+ * Implement this hook to handle the destroy action.
38999
+ */
39000
+ onDestroy?: () => void;
39001
+ /**
39002
+ * Implement this hook to handle the mouse down action. The `row` and `col` parameters are based on the data range axis. Return `true` means prevent the next sheet actions. Default is false.
39003
+ */
39004
+ onMouseDown?: (row: number, col: number, e: MouseEvent) => boolean;
39005
+ /**
39006
+ * Implement this hook to handle the mouse move action. The `row` and `col` parameters are based on the data range axis. Return `true` means prevent the next sheet actions. Default is false.
39007
+ */
39008
+ onMouseMove?: (row: number, col: number, e: MouseEvent) => boolean;
39009
+ /**
39010
+ * Implement this hook to handle the mouse up action. The `row` and `col` parameters are based on the data range axis. Return `true` means prevent the next sheet actions. Default is false.
39011
+ */
39012
+ onMouseUp?: (row: number, col: number, e: MouseEvent) => boolean;
39013
+ /**
39014
+ * Implement this hook to handle the mouse context menu action. The `row` and `col` parameters are based on the data range axis. Return `true` means prevent the next sheet actions. Default is false.
39015
+ */
39016
+ onContextMenu?: (row: number, col: number, e: MouseEvent) => boolean;
39017
+ /**
39018
+ * Implement this hook to handle the mouse double click action. The `row` and `col` parameters are based on the data range axis. Return `true` means prevent the next sheet actions. Default is false.
39019
+ */
39020
+ onDoubleClick?: (row: number, col: number, e: MouseEvent) => boolean;
39021
+ /**
39022
+ * Implement this hook to handle the mouse wheel action. Return `true` means prevent the next sheet actions. Default is false.
39023
+ */
39024
+ onMouseWheel?: (deltaX: number, deltaY: number, e: MouseEvent) => boolean;
39025
+ /**
39026
+ * Implement this hook to handle the key down action. The `row` and `col` parameters are based on the data range axis. Return `true` means prevent the next sheet actions. Default is false.
39027
+ */
39028
+ onKeyDown?: (row: number, col: number, e: KeyboardEvent) => boolean;
39029
+ /**
39030
+ * Implement this hook to handle the key down action. The `row` and `col` parameters are based on the data range axis. Return `true` means prevent the next sheet actions. Default is false.
39031
+ */
39032
+ onKeyUp?: (row: number, col: number, e: KeyboardEvent) => boolean;
39033
+ /**
39034
+ * Implement this hook to handle the undo action. Input parameter `change` is the user created in the corresponding hooks.
39035
+ */
39036
+ undo?: (change: any) => void;
39037
+ /**
39038
+ * Implement this hook to handle the serialization.
39039
+ */
39040
+ toJSON?: () => { typeName: string, [prop: string]: any };
39041
+ /**
39042
+ * Implement this hook to handle the deserialization.
39043
+ */
39044
+ fromJSON?: (options: { typeName: string, [prop: string]: any }) => void;
39045
+ }
39046
+
39047
+
39048
+ export interface IDataRangeOptions{
39049
+ /**
39050
+ * Indicates the top rows count to be sticked.
39051
+ */
39052
+ sticky: { top: number };
39053
+ }
39054
+
39055
+
39056
+ export class DataRange{
39057
+ /**
39058
+ * Represents a data range.
39059
+ * @class
39060
+ * @param {string} name The name of the data range.
39061
+ * @param {GC.Spread.Sheets.DataRange.IDataProvider} dataProvider The data provider of the data range.
39062
+ * @param {GC.Spread.Sheets.Range} range The range of the data range.
39063
+ * @param {GC.Spread.Sheets.DataRange.IDataRangeOptions} [options] The options of the data range.
39064
+ */
39065
+ constructor(name: string, dataProvider: GC.Spread.Sheets.DataRange.IDataProvider, range: GC.Spread.Sheets.Range, options?: GC.Spread.Sheets.DataRange.IDataRangeOptions);
39066
+ /**
39067
+ * @description Get or set the name of the data range.
39068
+ * @param {string} [name] this name of the data range
39069
+ * @returns {string} If no value is set, returns the name of the data range.
39070
+ */
39071
+ name(name?: string): string;
39072
+ /**
39073
+ * @description Get or set the range of the data range.
39074
+ * @param {GC.Spread.Sheets.Range} [range] this range of the data range
39075
+ * @returns {GC.Spread.Sheets.Range} If no value is set, returns the range of the data range.
39076
+ */
39077
+ range(range?: GC.Spread.Sheets.Range): GC.Spread.Sheets.Range;
39078
+ /**
39079
+ * @description repaint the data range
39080
+ */
39081
+ repaint(): void;
39082
+ }
39083
+
39084
+ export class DataRangeManager{
39085
+ /**
39086
+ * @description Represents a data range manager.
39087
+ * @class
39088
+ * @param {GC.Spread.Sheets.Worksheet} sheet The worksheet.
39089
+ */
39090
+ constructor(sheet: GC.Spread.Sheets.Worksheet);
39091
+ /**
39092
+ * @description Adds a data range.
39093
+ * @param {string} name The data range name.
39094
+ * @param {GC.Spread.Sheets.DataRange.IDataProvider | string} dataProvider The data provider. String type means the tableSheet name, it will create a TableSheetDataProvider.
39095
+ * @param {GC.Spread.Sheets.Range} range The range of data range.
39096
+ * @param {GC.Spread.Sheets.DataRange.IDataRangeOptions} [options] The data range options.
39097
+ * @returns {GC.Spread.Sheets.DataRange.DataRange} The added data range.
39098
+ */
39099
+ add(name: string, dataProvider: GC.Spread.Sheets.DataRange.IDataProvider | string, range: GC.Spread.Sheets.Range, options?: GC.Spread.Sheets.DataRange.IDataRangeOptions): GC.Spread.Sheets.DataRange.DataRange;
39100
+ /**
39101
+ * @description Get all data ranges.
39102
+ * @returns {GC.Spread.Sheets.DataRange.DataRange[]} The array of data range instances. Default is empty array.
39103
+ */
39104
+ all(): GC.Spread.Sheets.DataRange.DataRange[];
39105
+ /**
39106
+ * @description Remove all data ranges.
39107
+ */
39108
+ clear(): void;
39109
+ /**
39110
+ * @description Gets a data range.
39111
+ * @param {string} name The data range name.
39112
+ * @returns {GC.Spread.Sheets.DataRange.DataRange} The target data range.
39113
+ */
39114
+ get(name: string): GC.Spread.Sheets.DataRange.DataRange;
39115
+ /**
39116
+ * @description Remove a data range.
39117
+ * @param {string} name The data range name.
39118
+ */
39119
+ remove(name: string): void;
39120
+ }
39121
+ }
39122
+
37235
39123
  module DataValidation{
37236
39124
  /**
37237
39125
  * Creates a validator based on the data.
@@ -37477,6 +39365,19 @@ declare module GC{
37477
39365
  /**
37478
39366
  * Indicates the data validation highlightposition.
37479
39367
  * @enum {number}
39368
+ * @example
39369
+ * ```
39370
+ * //This example uses the highlightStyle method.
39371
+ * sheet.setValue(1, 1, "sss");
39372
+ * var dv = GC.Spread.Sheets.DataValidation.createListValidator('Fruit,Vegetable,Food');
39373
+ * dv.highlightStyle({
39374
+ * type:GC.Spread.Sheets.DataValidation.HighlightType.dogEar,
39375
+ * color:'blue',
39376
+ * position:GC.Spread.Sheets.DataValidation.HighlightPosition.topLeft
39377
+ * });
39378
+ * sheet.setDataValidator(1,1, dv);
39379
+ * spread.options.highlightInvalidData = true;
39380
+ * ```
37480
39381
  */
37481
39382
  export enum HighlightPosition{
37482
39383
  /**
@@ -37508,6 +39409,19 @@ declare module GC{
37508
39409
  /**
37509
39410
  * Indicates the data validation highlightType.
37510
39411
  * @enum {number}
39412
+ * @example
39413
+ * ```
39414
+ * //This example uses the highlightStyle method.
39415
+ * sheet.setValue(1, 1, "sss");
39416
+ * var dv = GC.Spread.Sheets.DataValidation.createListValidator('Fruit,Vegetable,Food');
39417
+ * dv.highlightStyle({
39418
+ * type:GC.Spread.Sheets.DataValidation.HighlightType.dogEar,
39419
+ * color:'blue',
39420
+ * position:GC.Spread.Sheets.DataValidation.HighlightPosition.topLeft
39421
+ * });
39422
+ * sheet.setDataValidator(1,1, dv);
39423
+ * spread.options.highlightInvalidData = true;
39424
+ * ```
37511
39425
  */
37512
39426
  export enum HighlightType{
37513
39427
  /**
@@ -37550,18 +39464,52 @@ declare module GC{
37550
39464
  * Gets or sets the condition to validate.
37551
39465
  * @param {GC.Spread.Sheets.ConditionalFormatting.Condition} [value] The condition to validate.
37552
39466
  * @returns {GC.Spread.Sheets.ConditionalFormatting.Condition | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the condition to validate; otherwise, returns the data validator.
39467
+ * @example
39468
+ * ```
39469
+ * var nCondition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.averageCondition, {compareType: GC.Spread.Sheets.ConditionalFormatting.AverageConditionType.above});
39470
+ * nCondition.ranges([new GC.Spread.Sheets.Range(0, 0, 10, 3)]);
39471
+ * var validator = new GC.Spread.Sheets.DataValidation.DefaultDataValidator();
39472
+ * validator.type(GC.Spread.Sheets.DataValidation.CriteriaType.custom);
39473
+ * validator.condition(nCondition);
39474
+ * activeSheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(validator);
39475
+ * spread.options.highlightInvalidData = true;
39476
+ * activeSheet.setValue(0, 0, 5);
39477
+ * activeSheet.setValue(1, 0, 15);
39478
+ * ```
37553
39479
  */
37554
39480
  condition(value?: GC.Spread.Sheets.ConditionalFormatting.Condition): any;
37555
39481
  /**
37556
39482
  * Gets or sets the error message.
37557
39483
  * @param {string} [value] The error message.
37558
39484
  * @returns {string | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the error message; otherwise, returns the data validator.
39485
+ * @example
39486
+ * ```
39487
+ * var nCondition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.cellValueCondition);
39488
+ * nCondition.compareType(GC.Spread.Sheets.ConditionalFormatting.GeneralComparisonOperators.equalsTo);
39489
+ * nCondition.expected(0);
39490
+ * var validator = new GC.Spread.Sheets.DataValidation.DefaultDataValidator(nCondition);
39491
+ * validator.type(GC.Spread.Sheets.DataValidation.CriteriaType.custom);
39492
+ * validator.errorMessage('Incorrect input, please input a positive number');
39493
+ * activeSheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(validator);
39494
+ * ```
37559
39495
  */
37560
39496
  errorMessage(value?: string): any;
37561
39497
  /**
37562
39498
  * Gets or sets the error style to display.
37563
39499
  * @param {GC.Spread.Sheets.DataValidation.ErrorStyle} [value] The error style to display.
37564
39500
  * @returns {GC.Spread.Sheets.DataValidation.ErrorStyle | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the error style to display; otherwise, returns the data validator.
39501
+ * @example
39502
+ * ```
39503
+ * var nCondition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.averageCondition, {compareType: GC.Spread.Sheets.ConditionalFormatting.AverageConditionType.above});
39504
+ * nCondition.ranges([new GC.Spread.Sheets.Range(0, 0, 10, 3)]);
39505
+ * var validator = new GC.Spread.Sheets.DataValidation.DefaultDataValidator(nCondition);
39506
+ * validator.type(GC.Spread.Sheets.DataValidation.CriteriaType.custom);
39507
+ * validator.errorStyle(GC.Spread.Sheets.DataValidation.ErrorStyle.warning);
39508
+ * activeSheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(validator);
39509
+ * spread.options.highlightInvalidData = true;
39510
+ * activeSheet.setValue(0, 0, 5);
39511
+ * activeSheet.setValue(1, 0, 15);
39512
+ * ```
37565
39513
  */
37566
39514
  errorStyle(value?: GC.Spread.Sheets.DataValidation.ErrorStyle): any;
37567
39515
  /**
@@ -37576,6 +39524,16 @@ declare module GC{
37576
39524
  * @param {number} baseRow The base row.
37577
39525
  * @param {number} baseColumn The base column.
37578
39526
  * @returns {Object[]} The valid data lists or null.
39527
+ * @example
39528
+ * ```
39529
+ * spread.options.highlightInvalidData = true;
39530
+ * var dv = GC.Spread.Sheets.DataValidation.createListValidator("1,2,3");
39531
+ * dv.showInputMessage(true);
39532
+ * dv.inputMessage("Value must be 1,2 or 3");
39533
+ * dv.inputTitle("tip");
39534
+ * activeSheet.setDataValidator(1,1,1,1,dv, GC.Spread.Sheets.SheetArea.viewport);
39535
+ * alert(activeSheet.getDataValidator(1,1).getValidList(activeSheet,1,1));
39536
+ * ```
37579
39537
  */
37580
39538
  getValidList(evaluator: Object, baseRow: number, baseColumn: number): any[];
37581
39539
  /**
@@ -37787,6 +39745,21 @@ declare module GC{
37787
39745
  * Gets or sets the criteria type of this data validator.
37788
39746
  * @param {GC.Spread.Sheets.DataValidation.CriteriaType} [value] The criteria type of this data validator.
37789
39747
  * @returns {GC.Spread.Sheets.DataValidation.CriteriaType | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the criteria type of this data validator; otherwise, returns the data validator.
39748
+ * @example
39749
+ * ```
39750
+ * //This example uses the preciseCompareDate method.
39751
+ * var dateCondition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.dateCondition);
39752
+ * dateCondition.compareType(GC.Spread.Sheets.ConditionalFormatting.DateCompareType.after);
39753
+ * dateCondition.expected(new Date(2020, 4, 22, 6));
39754
+ * //When the option is false, the validator compares the whole day, and they are the same, so validation fails and the red alert is displayed.
39755
+ * //When the option is true, the date time 7 o'clock is greater than 6 o'clock, so the result is successful.
39756
+ * var validator = new GC.Spread.Sheets.DataValidation.DefaultDataValidator(dateCondition);
39757
+ * validator.type(GC.Spread.Sheets.DataValidation.CriteriaType.date);
39758
+ * validator.preciseCompareDate(true);
39759
+ * activeSheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(validator);
39760
+ * spread.options.highlightInvalidData = true;
39761
+ * activeSheet.setValue(0, 0, new Date(2020, 4, 22, 7));
39762
+ * ```
37790
39763
  */
37791
39764
  type(value?: GC.Spread.Sheets.DataValidation.CriteriaType): any;
37792
39765
  /**
@@ -39520,13 +41493,28 @@ declare module GC{
39520
41493
  constructor(host: HTMLElement, options?: GC.Spread.Sheets.FormulaTextBox.IFormulaTextBoxOptions);
39521
41494
  /**
39522
41495
  * Adds a custom function description.
39523
- * @param {GC.Spread.CalcEngine.Functions.IFunctionDescription} functionDescription The function description to add. This can be an array. See the Remarks for more information.
41496
+ * @param {GC.Spread.CalcEngine.Functions.IFunctionDescription | GC.Spread.CalcEngine.Functions.IFunctionDescription[]} functionDescription The function description to add. This can be an array. See the Remarks for more information.
39524
41497
  */
39525
- add(functionDescription: GC.Spread.CalcEngine.Functions.IFunctionDescription): void;
41498
+ add(functionDescription: GC.Spread.CalcEngine.Functions.IFunctionDescription | GC.Spread.CalcEngine.Functions.IFunctionDescription[]): void;
39526
41499
  /**
39527
41500
  * Gets or sets whether the text box uses automatic complete.
39528
- * @param {boolean} value Whether to use automatic complete when editing.
41501
+ * @param {boolean} [value] Whether to use automatic complete when editing.
39529
41502
  * @returns {boolean} If no value is set, returns whether the text box uses auto complete; otherwise, there is no return value.
41503
+ * @example
41504
+ * ```
41505
+ * var spread = new GC.Spread.Sheets.Workbook(_getElementById('ss'), { sheetCount: 2 });
41506
+ * var div = document.createElement('div');
41507
+ * div.id = 'fbx';
41508
+ * div.style.width = '300px';
41509
+ * div.style.height = '50px';
41510
+ * div.setAttribute('contentEditable', 'true');
41511
+ * document.getElementById('panel').appendChild(div);
41512
+ * var formulaTextBox = new GC.Spread.Sheets.FormulaTextBox.FormulaTextBox(div);
41513
+ * formulaTextBox.workbook(spread);
41514
+ * formulaTextBox.autoComplete(false);
41515
+ *
41516
+ * // input "=SUM" formula prefix in the formula text box input element, the func hint box will not show
41517
+ * ```
39530
41518
  */
39531
41519
  autoComplete(value?: boolean): boolean;
39532
41520
  /**
@@ -39545,14 +41533,44 @@ declare module GC{
39545
41533
  remove(name: string): void;
39546
41534
  /**
39547
41535
  * Gets or sets whether to display the function's help tip.
39548
- * @param {boolean} value Whether to display the function's help tip when editing.
41536
+ * @param {boolean} [value] Whether to display the function's help tip when editing.
39549
41537
  * @returns {boolean} If no value is set, returns whether the text box displays the function's help tip when editing; otherwise, there is no return value.
41538
+ * @example
41539
+ * ```
41540
+ * var spread = new GC.Spread.Sheets.Workbook(_getElementById('ss'), { sheetCount: 2 });
41541
+ * var div = document.createElement('div');
41542
+ * div.id = 'fbx';
41543
+ * div.style.width = '300px';
41544
+ * div.style.height = '50px';
41545
+ * div.setAttribute('contentEditable', 'true');
41546
+ * document.getElementById('panel').appendChild(div);
41547
+ * var formulaTextBox = new GC.Spread.Sheets.FormulaTextBox.FormulaTextBox(div);
41548
+ * formulaTextBox.workbook(spread);
41549
+ * formulaTextBox.showHelp(false);
41550
+ *
41551
+ * // input "=SUM" formula prefix in the formula text box input element, the func hint (auto complete) box iwll show, but the help func will not show
41552
+ * ```
39550
41553
  */
39551
41554
  showHelp(value?: boolean): any;
39552
41555
  /**
39553
41556
  * Gets or sets the text.
39554
- * @param {string} value The text.
41557
+ * @param {string} [value] The text.
39555
41558
  * @returns {string} If no value is set, returns the text; otherwise, there is no return value.
41559
+ * @example
41560
+ * ```
41561
+ * var spread = new GC.Spread.Sheets.Workbook(_getElementById('ss'), { sheetCount: 2 });
41562
+ * var div = document.createElement('div');
41563
+ * div.id = 'fbx';
41564
+ * div.style.width = '300px';
41565
+ * div.style.height = '50px';
41566
+ * div.setAttribute('contentEditable', 'true');
41567
+ * document.getElementById('panel').appendChild(div);
41568
+ * var formulaTextBox = new GC.Spread.Sheets.FormulaTextBox.FormulaTextBox(div);
41569
+ * formulaTextBox.workbook(spread);
41570
+ * formulaTextBox.text('this is text');
41571
+ * // worksheet will be in edit status with the text value and formula text box input box will also show the text value.
41572
+ * console.log(formulaTextBox.text()); // 'this is text'
41573
+ * ```
39556
41574
  */
39557
41575
  text(value?: string): string;
39558
41576
  /**
@@ -41309,6 +43327,22 @@ declare module GC{
41309
43327
  * @property {boolean} [enableNavigateToRange] Indicates whether enable navigate to the named range or drawing item when input its name or click on custom list item.
41310
43328
  * @property {boolean} [showCustomNameList] Indicates whether show the custom name list dropdown indicator.
41311
43329
  * @property {number} [dropDownMaxHeight] Indicates the drop down list element max height.
43330
+ * @example
43331
+ * ```
43332
+ * var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
43333
+ * var div = document.createElement('div');
43334
+ * div.id = 'nameBox';
43335
+ * div.style.width = '300px';
43336
+ * div.style.height = '50px';
43337
+ * document.getElementById('panel').appendChild(div);
43338
+ *
43339
+ * var nameBox = new GC.Spread.Sheets.NameBox.NameBox(document.getElementById('nameBox'), spread);
43340
+ * nameBox.options.enableAddCustomName = false; // cannot add custom name with inputting in name box input box now.
43341
+ * nameBox.options.enableNavigateToRange = false; // cannot swap the selected range to the value of the name box input box now.
43342
+ * nameBox.options.showCustomNameList = false; // cannot open the custom name list by down arrow button right side and the button will be hidden now.
43343
+ * nameBox.options.dropDownMaxHeight = 100; // the custom name list host DOM element height will no larger than 100px now.
43344
+ *
43345
+ * ```
41312
43346
  */
41313
43347
  options: GC.Spread.Sheets.NameBox.INameBoxOptions;
41314
43348
  /**
@@ -41396,26 +43430,110 @@ declare module GC{
41396
43430
  * Gets the check status of the row or all rows.
41397
43431
  * @param {number} [row] The index of the row.
41398
43432
  * @returns {boolean|boolean[]} If row is undefined, returns all row's check status; otherwise, returns the check status of the row.
43433
+ * @example
43434
+ * ```
43435
+ * spread.suspendPaint();
43436
+ * activeSheet.setValue(0, 0, "Name", GC.Spread.Sheets.SheetArea.colHeader);
43437
+ * activeSheet.setValue(0, 1, "Chapter", GC.Spread.Sheets.SheetArea.colHeader);
43438
+ * activeSheet.setValue(0, 2, "Page", GC.Spread.Sheets.SheetArea.colHeader);
43439
+ * activeSheet.setColumnWidth(0, 200);
43440
+ * activeSheet.setRowCount(13);
43441
+ * var commands = [
43442
+ * {name: 'Preface', chapter: '1', page: 1, indent: 0},
43443
+ * {name: 'Java SE5 and SE6', chapter: '1.1', page: 2, indent: 1},
43444
+ * {name: 'Java SE6', chapter: '1.1.1', page: 2, indent: 2},
43445
+ * {name: 'The 4th edition', chapter: '1.2', page: 2, indent: 1},
43446
+ * {name: 'Changes', chapter: '1.2.1', page: 3, indent: 2},
43447
+ * {name: 'Note on the cover design', chapter: '1.3', page: 4, indent: 1},
43448
+ * {name: 'Acknowledgements', chapter: '1.4', page: 4, indent: 1},
43449
+ * {name: 'Introduction', chapter: '2', page: 9, indent: 0},
43450
+ * {name: 'Prerequisites', chapter: '2.1', page: 9, indent: 1},
43451
+ * {name: 'Learning Java', chapter: '2.2', page: 10, indent: 1},
43452
+ * {name: 'Goals', chapter: '2.3', page: 10, indent: 1},
43453
+ * {name: 'Teaching from this book', chapter: '2.4', page: 11, indent: 1},
43454
+ * {name: 'JDK HTML documentation', chapter: '2.5', page: 11, indent: 1},
43455
+ * ];
43456
+ * for (var r = 0; r < commands.length; r++) {
43457
+ * activeSheet.setValue(r, 0, commands[r]['name']);
43458
+ * activeSheet.setValue(r, 1, commands[r]['chapter']);
43459
+ * activeSheet.setValue(r, 2, commands[r]['page']);
43460
+ * activeSheet.getRange(r, 0, 1, 1).textIndent(commands[r].indent);
43461
+ * }
43462
+ * activeSheet.outlineColumn.options({
43463
+ * columnIndex: 0,
43464
+ * showImage: true,
43465
+ * showCheckBox: true,
43466
+ * images: ['star2.png', 'box4.png', 'rating4.png'],
43467
+ * maxLevel: 2
43468
+ * });
43469
+ * activeSheet.showRowOutline(true);
43470
+ * spread.invalidateLayout();
43471
+ * spread.resumePaint();
43472
+ *
43473
+ * console.log(activeSheet.outlineColumn.getCheckStatus(1)); // false
43474
+ * activeSheet.outlineColumn.setCheckStatus(1, true);
43475
+ * console.log(activeSheet.outlineColumn.getCheckStatus(1)); // true
43476
+ * console.log(activeSheet.outlineColumn.getCheckStatus(2)); // true -> sub node of row 1
43477
+ * console.log(activeSheet.outlineColumn.getCheckStatus()); // [false, true, true, false, false, false, false, false, false, false, false, false, false]
43478
+ * ```
41399
43479
  */
41400
43480
  getCheckStatus(row?: number): any;
41401
43481
  /**
41402
43482
  * Gets the collapsed setting of the row or all rows.
41403
43483
  * @param {number} [row] The index of the collapsed row.
41404
43484
  * @returns {boolean|boolean[]} If row is undefined, returns all row's collapsed status; otherwise, returns the collapsed setting of the row.
43485
+ * @example
43486
+ * ```
43487
+ * spread.suspendPaint();
43488
+ * activeSheet.setValue(0, 0, "Name", GC.Spread.Sheets.SheetArea.colHeader);
43489
+ * activeSheet.setValue(0, 1, "Chapter", GC.Spread.Sheets.SheetArea.colHeader);
43490
+ * activeSheet.setValue(0, 2, "Page", GC.Spread.Sheets.SheetArea.colHeader);
43491
+ * activeSheet.setColumnWidth(0, 200);
43492
+ * activeSheet.setRowCount(13);
43493
+ * var commands = [
43494
+ * {name: 'Preface', chapter: '1', page: 1, indent: 0},
43495
+ * {name: 'Java SE5 and SE6', chapter: '1.1', page: 2, indent: 1},
43496
+ * {name: 'Java SE6', chapter: '1.1.1', page: 2, indent: 2},
43497
+ * {name: 'The 4th edition', chapter: '1.2', page: 2, indent: 1},
43498
+ * {name: 'Changes', chapter: '1.2.1', page: 3, indent: 2},
43499
+ * {name: 'Note on the cover design', chapter: '1.3', page: 4, indent: 1},
43500
+ * {name: 'Acknowledgements', chapter: '1.4', page: 4, indent: 1},
43501
+ * {name: 'Introduction', chapter: '2', page: 9, indent: 0},
43502
+ * {name: 'Prerequisites', chapter: '2.1', page: 9, indent: 1},
43503
+ * {name: 'Learning Java', chapter: '2.2', page: 10, indent: 1},
43504
+ * {name: 'Goals', chapter: '2.3', page: 10, indent: 1},
43505
+ * {name: 'Teaching from this book', chapter: '2.4', page: 11, indent: 1},
43506
+ * {name: 'JDK HTML documentation', chapter: '2.5', page: 11, indent: 1},
43507
+ * ];
43508
+ * for (var r = 0; r < commands.length; r++) {
43509
+ * activeSheet.setValue(r, 0, commands[r]['name']);
43510
+ * activeSheet.setValue(r, 1, commands[r]['chapter']);
43511
+ * activeSheet.setValue(r, 2, commands[r]['page']);
43512
+ * activeSheet.getRange(r, 0, 1, 1).textIndent(commands[r].indent);
43513
+ * }
43514
+ * activeSheet.outlineColumn.options({
43515
+ * columnIndex: 0,
43516
+ * showImage: true,
43517
+ * showCheckBox: true,
43518
+ * images: ['star2.png', 'box4.png', 'rating4.png'],
43519
+ * maxLevel: 2
43520
+ * });
43521
+ * activeSheet.showRowOutline(true);
43522
+ * spread.invalidateLayout();
43523
+ * spread.resumePaint();
43524
+ *
43525
+ * console.log(activeSheet.outlineColumn.getCollapsed(1)); // false
43526
+ * activeSheet.outlineColumn.setCollapsed(1, true);
43527
+ * console.log(activeSheet.outlineColumn.getCollapsed(1)); // true
43528
+ * console.log(activeSheet.outlineColumn.getCollapsed(2)); // false -> sub node of row 1
43529
+ * console.log(activeSheet.outlineColumn.getCollapsed()); // [false, true, false, false, false, false, false, false, false, false, false, false, false]
43530
+ * ```
41405
43531
  */
41406
43532
  getCollapsed(row?: number): any;
41407
43533
  /**
41408
43534
  * Gets or sets the outlineColumn options.
41409
- * @param {Object} outlineColumnOptions The outlineColumn options.
41410
- * @param {number} outlineColumnOptions.columnIndex - The index of the indented column.
41411
- * @param {boolean} [outlineColumnOptions.showImage] - Whether to display images.
41412
- * @param {string[]} [outlineColumnOptions.images] - The images by level (url or base64Image).
41413
- * @param {boolean} [outlineColumnOptions.showCheckBox] - Whether to display a check box.
41414
- * @param {boolean} [outlineColumnOptions.showIndicator] - Whether to display the indicator.
41415
- * @param {string} [outlineColumnOptions.expandIndicator] - The expand indicator (url or base64Image).
41416
- * @param {string} [outlineColumnOptions.collapseIndicator] - The collapse indicator (url or base64Image).
41417
- * @param {number} [outlineColumnOptions.maxLevel] - When the current row level is greater than maxLevel, the IncreaseCellIndent action does not take effect.
41418
- * @returns {Object | GC.Spread.Sheets.OutlineColumn.OutlineColumn} outlineColumnOptions|outlineColumn
43535
+ * @param {GC.Spread.Sheets.OutlineColumn.IOutlineColumnOptions} outlineColumnOptions The outlineColumn options.
43536
+ * @returns {GC.Spread.Sheets.OutlineColumn.IOutlineColumnOptions | GC.Spread.Sheets.OutlineColumn.OutlineColumn} outlineColumnOptions|outlineColumn
41419
43537
  * If no outlineColumnOptions item is set, returns outlineColumnOptions; otherwise, returns the outlineColumn instance.
41420
43538
  * @example
41421
43539
  * ```
@@ -41497,12 +43615,102 @@ declare module GC{
41497
43615
  * Sets the check status of the row.
41498
43616
  * @param {number} row The index of the row.
41499
43617
  * @param {boolean} checkStatus The check status of the row.
43618
+ * @example
43619
+ * ```
43620
+ * spread.suspendPaint();
43621
+ * activeSheet.setValue(0, 0, "Name", GC.Spread.Sheets.SheetArea.colHeader);
43622
+ * activeSheet.setValue(0, 1, "Chapter", GC.Spread.Sheets.SheetArea.colHeader);
43623
+ * activeSheet.setValue(0, 2, "Page", GC.Spread.Sheets.SheetArea.colHeader);
43624
+ * activeSheet.setColumnWidth(0, 200);
43625
+ * activeSheet.setRowCount(13);
43626
+ * var commands = [
43627
+ * {name: 'Preface', chapter: '1', page: 1, indent: 0},
43628
+ * {name: 'Java SE5 and SE6', chapter: '1.1', page: 2, indent: 1},
43629
+ * {name: 'Java SE6', chapter: '1.1.1', page: 2, indent: 2},
43630
+ * {name: 'The 4th edition', chapter: '1.2', page: 2, indent: 1},
43631
+ * {name: 'Changes', chapter: '1.2.1', page: 3, indent: 2},
43632
+ * {name: 'Note on the cover design', chapter: '1.3', page: 4, indent: 1},
43633
+ * {name: 'Acknowledgements', chapter: '1.4', page: 4, indent: 1},
43634
+ * {name: 'Introduction', chapter: '2', page: 9, indent: 0},
43635
+ * {name: 'Prerequisites', chapter: '2.1', page: 9, indent: 1},
43636
+ * {name: 'Learning Java', chapter: '2.2', page: 10, indent: 1},
43637
+ * {name: 'Goals', chapter: '2.3', page: 10, indent: 1},
43638
+ * {name: 'Teaching from this book', chapter: '2.4', page: 11, indent: 1},
43639
+ * {name: 'JDK HTML documentation', chapter: '2.5', page: 11, indent: 1},
43640
+ * ];
43641
+ * for (var r = 0; r < commands.length; r++) {
43642
+ * activeSheet.setValue(r, 0, commands[r]['name']);
43643
+ * activeSheet.setValue(r, 1, commands[r]['chapter']);
43644
+ * activeSheet.setValue(r, 2, commands[r]['page']);
43645
+ * activeSheet.getRange(r, 0, 1, 1).textIndent(commands[r].indent);
43646
+ * }
43647
+ * activeSheet.outlineColumn.options({
43648
+ * columnIndex: 0,
43649
+ * showImage: true,
43650
+ * showCheckBox: true,
43651
+ * images: ['star2.png', 'box4.png', 'rating4.png'],
43652
+ * maxLevel: 2
43653
+ * });
43654
+ * activeSheet.showRowOutline(true);
43655
+ * spread.invalidateLayout();
43656
+ * spread.resumePaint();
43657
+ *
43658
+ * console.log(activeSheet.outlineColumn.getCheckStatus(1)); // false
43659
+ * activeSheet.outlineColumn.setCheckStatus(1, true);
43660
+ * console.log(activeSheet.outlineColumn.getCheckStatus(1)); // true
43661
+ * console.log(activeSheet.outlineColumn.getCheckStatus(2)); // true -> sub node of row 1
43662
+ * ```
41500
43663
  */
41501
43664
  setCheckStatus(row: number, checkStatus: boolean): void;
41502
43665
  /**
41503
43666
  * Sets whether the row is collapsed.
41504
43667
  * @param {number} row The index of the row.
41505
43668
  * @param {boolean} collapsed The collapsed setting for the row.
43669
+ * @example
43670
+ * ```
43671
+ * spread.suspendPaint();
43672
+ * activeSheet.setValue(0, 0, "Name", GC.Spread.Sheets.SheetArea.colHeader);
43673
+ * activeSheet.setValue(0, 1, "Chapter", GC.Spread.Sheets.SheetArea.colHeader);
43674
+ * activeSheet.setValue(0, 2, "Page", GC.Spread.Sheets.SheetArea.colHeader);
43675
+ * activeSheet.setColumnWidth(0, 200);
43676
+ * activeSheet.setRowCount(13);
43677
+ * var commands = [
43678
+ * {name: 'Preface', chapter: '1', page: 1, indent: 0},
43679
+ * {name: 'Java SE5 and SE6', chapter: '1.1', page: 2, indent: 1},
43680
+ * {name: 'Java SE6', chapter: '1.1.1', page: 2, indent: 2},
43681
+ * {name: 'The 4th edition', chapter: '1.2', page: 2, indent: 1},
43682
+ * {name: 'Changes', chapter: '1.2.1', page: 3, indent: 2},
43683
+ * {name: 'Note on the cover design', chapter: '1.3', page: 4, indent: 1},
43684
+ * {name: 'Acknowledgements', chapter: '1.4', page: 4, indent: 1},
43685
+ * {name: 'Introduction', chapter: '2', page: 9, indent: 0},
43686
+ * {name: 'Prerequisites', chapter: '2.1', page: 9, indent: 1},
43687
+ * {name: 'Learning Java', chapter: '2.2', page: 10, indent: 1},
43688
+ * {name: 'Goals', chapter: '2.3', page: 10, indent: 1},
43689
+ * {name: 'Teaching from this book', chapter: '2.4', page: 11, indent: 1},
43690
+ * {name: 'JDK HTML documentation', chapter: '2.5', page: 11, indent: 1},
43691
+ * ];
43692
+ * for (var r = 0; r < commands.length; r++) {
43693
+ * activeSheet.setValue(r, 0, commands[r]['name']);
43694
+ * activeSheet.setValue(r, 1, commands[r]['chapter']);
43695
+ * activeSheet.setValue(r, 2, commands[r]['page']);
43696
+ * activeSheet.getRange(r, 0, 1, 1).textIndent(commands[r].indent);
43697
+ * }
43698
+ * activeSheet.outlineColumn.options({
43699
+ * columnIndex: 0,
43700
+ * showImage: true,
43701
+ * showCheckBox: true,
43702
+ * images: ['star2.png', 'box4.png', 'rating4.png'],
43703
+ * maxLevel: 2
43704
+ * });
43705
+ * activeSheet.showRowOutline(true);
43706
+ * spread.invalidateLayout();
43707
+ * spread.resumePaint();
43708
+ *
43709
+ * console.log(activeSheet.outlineColumn.getCollapsed(1)); // false
43710
+ * activeSheet.outlineColumn.setCollapsed(1, true);
43711
+ * console.log(activeSheet.outlineColumn.getCollapsed(1)); // true
43712
+ * console.log(activeSheet.outlineColumn.getCollapsed(2)); // false -> sub node of row 1
43713
+ * ```
41506
43714
  */
41507
43715
  setCollapsed(row: number, collapsed: boolean): void;
41508
43716
  }
@@ -41597,6 +43805,15 @@ declare module GC{
41597
43805
  * Expands or collapses the specified outline (range group) of rows or columns.
41598
43806
  * @param {GC.Spread.Sheets.Outlines.OutlineInfo} groupInfo The group information of the range group.
41599
43807
  * @param {boolean} expand Whether to expand the groups.
43808
+ * @example
43809
+ * ```
43810
+ * activeSheet.suspendPaint();
43811
+ * activeSheet.rowOutlines.group(2, 5);
43812
+ * var groupInfo = activeSheet.rowOutlines.find(2, 0);
43813
+ * activeSheet.rowOutlines.expandGroup(groupInfo, false);
43814
+ * activeSheet.resumePaint(); // the group is created and collapsed now.
43815
+ * activeSheet.rowOutlines.expandGroup(groupInfo, true); // the group and expand now.
43816
+ * ```
41600
43817
  */
41601
43818
  expandGroup(groupInfo: GC.Spread.Sheets.Outlines.OutlineInfo, expand: boolean): void;
41602
43819
  /**
@@ -41673,7 +43890,7 @@ declare module GC{
41673
43890
  * activeSheet.suspendPaint();
41674
43891
  * activeSheet.rowOutlines.group(0,5);
41675
43892
  * var rgi = activeSheet.rowOutlines.find(1, 0);
41676
- * rgi.state(GC.Spread.Sheets.Outlines.OutlineInfo.collapsed);
43893
+ * rgi.state(GC.Spread.Sheets.Outlines.OutlineState.collapsed);
41677
43894
  * alert(activeSheet.rowOutlines.getState(rgi));
41678
43895
  * activeSheet.resumePaint();
41679
43896
  * ```
@@ -41712,7 +43929,19 @@ declare module GC{
41712
43929
  * Determines whether the specified index is the end of the group.
41713
43930
  * @param {number} index The index.
41714
43931
  * @param {number} processLevel The process level.
41715
- * @returns {boolean} `true` if the specfied index is the end of the group; otherwise, `false`.
43932
+ * @returns {boolean} `true` if the specified index is the end of the group; otherwise, `false`.
43933
+ * @example
43934
+ * ```
43935
+ * activeSheet.suspendPaint();
43936
+ * activeSheet.rowOutlines.group(2, 5);
43937
+ * activeSheet.rowOutlines.group(3, 2);
43938
+ * activeSheet.resumePaint();
43939
+ *
43940
+ * console.log(activeSheet.rowOutlines.isGroupEnd(2, 0)); // false
43941
+ * console.log(activeSheet.rowOutlines.isGroupEnd(4, 0)); // false
43942
+ * console.log(activeSheet.rowOutlines.isGroupEnd(4, 1)); // true
43943
+ * console.log(activeSheet.rowOutlines.isGroupEnd(6, 0)); // true
43944
+ * ```
41716
43945
  */
41717
43946
  isGroupEnd(index: number, processLevel: number): boolean;
41718
43947
  /**
@@ -41720,7 +43949,25 @@ declare module GC{
41720
43949
  */
41721
43950
  refresh(): void;
41722
43951
  /**
41723
- * Resumes the adding.
43952
+ * Resumes the adding group when the row/column is inserting the group range.
43953
+ * @example
43954
+ * ```
43955
+ * activeSheet.suspendPaint();
43956
+ * activeSheet.rowOutlines.group(2, 5);
43957
+ * activeSheet.resumePaint();
43958
+ *
43959
+ * console.log(activeSheet.rowOutlines.find(3, 0).end); // 6
43960
+ * console.log(activeSheet.rowOutlines.find(5, 0).end); // 6
43961
+ * activeSheet.addRows(4, 1);
43962
+ * console.log(activeSheet.rowOutlines.find(3, 0).end); // 7
43963
+ * console.log(activeSheet.rowOutlines.find(5, 0).end); // 7
43964
+ *
43965
+ * activeSheet.rowOutlines.suspendAdding();
43966
+ * activeSheet.addRows(4, 1);
43967
+ * console.log(activeSheet.rowOutlines.find(3, 0).end); // 3 // cause adding suspended, the group spilt into two parts.
43968
+ * console.log(activeSheet.rowOutlines.find(5, 0).end); // 8
43969
+ * activeSheet.rowOutlines.resumeAdding();
43970
+ * ```
41724
43971
  */
41725
43972
  resumeAdding(): void;
41726
43973
  /**
@@ -41738,7 +43985,25 @@ declare module GC{
41738
43985
  */
41739
43986
  setCollapsed(index: number, collapsed: boolean): void;
41740
43987
  /**
41741
- * Suspends the adding.
43988
+ * Suspends the adding group when the row/column is inserting the group range.
43989
+ * @example
43990
+ * ```
43991
+ * activeSheet.suspendPaint();
43992
+ * activeSheet.rowOutlines.group(2, 5);
43993
+ * activeSheet.resumePaint();
43994
+ *
43995
+ * console.log(activeSheet.rowOutlines.find(3, 0).end); // 6
43996
+ * console.log(activeSheet.rowOutlines.find(5, 0).end); // 6
43997
+ * activeSheet.addRows(4, 1);
43998
+ * console.log(activeSheet.rowOutlines.find(3, 0).end); // 7
43999
+ * console.log(activeSheet.rowOutlines.find(5, 0).end); // 7
44000
+ *
44001
+ * activeSheet.rowOutlines.suspendAdding();
44002
+ * activeSheet.addRows(4, 1);
44003
+ * console.log(activeSheet.rowOutlines.find(3, 0).end); // 3 // cause adding suspended, the group spilt into two parts.
44004
+ * console.log(activeSheet.rowOutlines.find(5, 0).end); // 8
44005
+ * activeSheet.rowOutlines.resumeAdding();
44006
+ * ```
41742
44007
  */
41743
44008
  suspendAdding(): void;
41744
44009
  /**
@@ -43319,7 +45584,12 @@ declare module GC{
43319
45584
  * Indicates that the string is found in the cell formula.
43320
45585
  * @type {number}
43321
45586
  */
43322
- cellFormula= 8
45587
+ cellFormula= 8,
45588
+ /**
45589
+ * Indicates that the string is found in the cell comment.
45590
+ * @type {number}
45591
+ */
45592
+ cellComment= 16
43323
45593
  }
43324
45594
 
43325
45595
  /**
@@ -49949,12 +52219,12 @@ declare module GC{
49949
52219
  */
49950
52220
  font(value?: string): any;
49951
52221
  /**
49952
- * Gets or sets the font size.
49953
- * @param {string} [value] The font size of the style information.
49954
- * @returns {string | GC.Spread.Sheets.Slicers.SlicerStyleInfo} If no value is set, returns the font size of the style information; otherwise, returns the slicer style information.
52222
+ * Gets or sets the font family.
52223
+ * @param {string} [value] The font family of the style information.
52224
+ * @returns {string | GC.Spread.Sheets.Slicers.SlicerStyleInfo} If no value is set, returns the font family of the style information; otherwise, returns the slicer style information.
49955
52225
  * @example
49956
52226
  * ```
49957
- * //This example sets a font size.
52227
+ * //This example sets a font family.
49958
52228
  * //create a table
49959
52229
  * var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 2 });
49960
52230
  * var activeSheet = spread.getActiveSheet();
@@ -49974,23 +52244,24 @@ declare module GC{
49974
52244
  * table.setColumnName(4, dataColumns[4]);
49975
52245
  * //style
49976
52246
  * var hstyle = new GC.Spread.Sheets.Slicers.SlicerStyleInfo();
49977
- * hstyle.fontSize("18pt");
52247
+ * hstyle.fontFamily("Arial Black");
49978
52248
  * var style1 = new GC.Spread.Sheets.Slicers.SlicerStyle();
49979
52249
  * style1.hoveredSelectedItemWithDataStyle(hstyle);
49980
52250
  * //add a slicer to the sheet and return the slicer instance.
49981
52251
  * var slicer = activeSheet.slicers.add("slicer1",table.name(),"Name");
49982
- * //change the slicer properties.
52252
+ * //change the slicer properties.
49983
52253
  * slicer.position(new GC.Spread.Sheets.Point(100, 200));
49984
52254
  * slicer.style(style1);
49985
- */ ///* function fontFamily(value?: string): any
49986
- /**
49987
- * Gets or sets the font family.
49988
52255
  * ```
49989
- * @param {string} [value] The font family of the style information.
49990
- * @returns {string | GC.Spread.Sheets.Slicers.SlicerStyleInfo} If no value is set, returns the font family of the style information; otherwise, returns the slicer style information.
52256
+ */
52257
+ fontFamily(value?: string): any;
52258
+ /**
52259
+ * Gets or sets the font size.
52260
+ * @param {string} [value] The font size of the style information.
52261
+ * @returns {string | GC.Spread.Sheets.Slicers.SlicerStyleInfo} If no value is set, returns the font size of the style information; otherwise, returns the slicer style information.
49991
52262
  * @example
49992
52263
  * ```
49993
- * //This example sets a font family.
52264
+ * //This example sets a font size.
49994
52265
  * //create a table
49995
52266
  * var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), { sheetCount: 2 });
49996
52267
  * var activeSheet = spread.getActiveSheet();
@@ -50010,12 +52281,12 @@ declare module GC{
50010
52281
  * table.setColumnName(4, dataColumns[4]);
50011
52282
  * //style
50012
52283
  * var hstyle = new GC.Spread.Sheets.Slicers.SlicerStyleInfo();
50013
- * hstyle.fontFamily("Arial Black");
52284
+ * hstyle.fontSize("18pt");
50014
52285
  * var style1 = new GC.Spread.Sheets.Slicers.SlicerStyle();
50015
52286
  * style1.hoveredSelectedItemWithDataStyle(hstyle);
50016
52287
  * //add a slicer to the sheet and return the slicer instance.
50017
52288
  * var slicer = activeSheet.slicers.add("slicer1",table.name(),"Name");
50018
- * //change the slicer properties.
52289
+ * //change the slicer properties.
50019
52290
  * slicer.position(new GC.Spread.Sheets.Point(100, 200));
50020
52291
  * slicer.style(style1);
50021
52292
  * ```
@@ -52987,7 +55258,7 @@ declare module GC{
52987
55258
  * Gets or sets the dataSource and binding columns and path for the table.
52988
55259
  * @param {GC.Spread.Sheets.Tables.TableColumn[]} columns The array of table column information with data fields and names. Each item is GC.Spread.Sheets.Tables.TableColumn.
52989
55260
  * @param {string} [path] The binding path for binding in the table.
52990
- * @param {object} [dataSource] The data source for the table.
55261
+ * @param {object | string | GC.Data.Table} [dataSource] The data source for the table.
52991
55262
  * @returns {GC.Spread.Sheets.Tables.Table} returns the table.
52992
55263
  * @example
52993
55264
  * ```
@@ -53013,7 +55284,7 @@ declare module GC{
53013
55284
  * table.bind([tableColumn1, tableColumn2, tableColumn3, tableColumn4, tableColumn5], 'sales', data);
53014
55285
  * ```
53015
55286
  */
53016
- bind(columns: TableColumn[], path?: string, dataSource?: object): GC.Spread.Sheets.Tables.Table;
55287
+ bind(columns: TableColumn[], path?: string, dataSource?: object | string | GC.Data.Table): GC.Spread.Sheets.Tables.Table;
53017
55288
  /**
53018
55289
  * Binds the columns using the specified data fields.
53019
55290
  * @param {GC.Spread.Sheets.Tables.TableColumn[]} columns The array of table column information with data fields and names. Each item is GC.Spread.Sheets.Tables.TableColumn.
@@ -53724,7 +55995,7 @@ declare module GC{
53724
55995
  * @param {string} name The table name.
53725
55996
  * @param {number} row The row index.
53726
55997
  * @param {number} column The column index.
53727
- * @param {object} dataSource The data source for the table.
55998
+ * @param {object | string | GC.Data.Table} dataSource The data source for the table.
53728
55999
  * @param {GC.Spread.Sheets.Tables.TableTheme} style The style of the table.
53729
56000
  * @param {GC.Spread.Sheets.Tables.ITableOptions} [options] The initialization options of the table.
53730
56001
  * @returns {GC.Spread.Sheets.Tables.Table} The new table instance.
@@ -53739,7 +56010,7 @@ declare module GC{
53739
56010
  * activeSheet.tables.addFromDataSource("Table1", 5, 2, source, GC.Spread.Sheets.Tables.TableThemes.dark1);
53740
56011
  * ```
53741
56012
  */
53742
- addFromDataSource(name: string, row: number, column: number, dataSource: Object, style: GC.Spread.Sheets.Tables.TableTheme, options?: GC.Spread.Sheets.Tables.ITableOptions): GC.Spread.Sheets.Tables.Table;
56013
+ addFromDataSource(name: string, row: number, column: number, dataSource: Object | string | GC.Data.Table, style: GC.Spread.Sheets.Tables.TableTheme, options?: GC.Spread.Sheets.Tables.ITableOptions): GC.Spread.Sheets.Tables.Table;
53743
56014
  /**
53744
56015
  * Gets all tables of the sheet.
53745
56016
  * @returns {GC.Spread.Sheets.Tables.Table[]} The GC.Spread.Sheets.Tables.Table array of table instances. The array is never null.