aspose.cells.node 25.2.0 → 25.3.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.
Files changed (3) hide show
  1. package/aspose.cells.js +26 -5
  2. package/package.json +5 -5
  3. package/types.d.ts +1000 -88
package/types.d.ts CHANGED
@@ -331,12 +331,54 @@ export enum AutoFitWrappedTextType {
331
331
  Paragraph = 1,
332
332
  }
333
333
 
334
+ /**
335
+ * Represents data infomation of font file data.
336
+ */
337
+ export class FontFileDataInfo {
338
+ /**
339
+ * Gets binary data of font file.
340
+ */
341
+ getData() : number[];
342
+ /**
343
+ * Gets font format type of font file.
344
+ */
345
+ getFormatType() : FontFileFormatType;
346
+ /**
347
+ * Checks whether the implementation object is null.
348
+ */
349
+ isNull() : boolean;
350
+ }
351
+
352
+ /**
353
+ * Represents font format type.
354
+ */
355
+ export enum FontFileFormatType {
356
+ /**
357
+ * Unknown font format type.
358
+ */
359
+ Unknown = 0,
360
+ /**
361
+ * TTF font format type.
362
+ */
363
+ Ttf = 1,
364
+ /**
365
+ * OTF font format type.
366
+ */
367
+ Otf = 2,
368
+ /**
369
+ * TTC font format type.
370
+ */
371
+ Ttc = 3,
372
+ }
373
+
334
374
  /**
335
375
  * Monitor for user to track the change of formulas during certain operations.
336
376
  *
337
377
  * @remarks
338
378
  * For example, while deleting/inserting range of cells,
339
379
  * formulas of other cells may be changed because of the shift of references.
380
+ * Please note, methods in the monitor may be invoked multiple times
381
+ * for one object which contains the formula.
340
382
  */
341
383
  export abstract class AbstractFormulaChangeMonitor {
342
384
  /**
@@ -346,6 +388,11 @@ export abstract class AbstractFormulaChangeMonitor {
346
388
  * @param columnIndex - The column index of the changed cell
347
389
  */
348
390
  abstract onCellFormulaChanged(sheetIndex: number, rowIndex: number, columnIndex: number) : void;
391
+ /**
392
+ * The event that will be triggered when the formula of FormatCondition is changed.
393
+ * @param fc - The FormatCondition object whose formula is changed
394
+ */
395
+ abstract onFormatConditionFormulaChanged(fc: FormatCondition) : void;
349
396
  }
350
397
 
351
398
  /**
@@ -1215,6 +1262,11 @@ export class DataModelTableCollection {
1215
1262
  * @param index - The position of the collection.
1216
1263
  */
1217
1264
  get(index: number) : DataModelTable;
1265
+ /**
1266
+ * Gets the data model table by the name.
1267
+ * @param name - The name of data model table.
1268
+ */
1269
+ get(name: string) : DataModelTable;
1218
1270
  /**
1219
1271
  * Gets the number of elements contained in.
1220
1272
  */
@@ -2181,6 +2233,24 @@ export class HtmlTableLoadOptionCollection {
2181
2233
  isNull() : boolean;
2182
2234
  }
2183
2235
 
2236
+ /**
2237
+ * Represents the header type of the table in the markdown file.
2238
+ */
2239
+ export enum MarkdownTableHeaderType {
2240
+ /**
2241
+ * First row as header of the table.
2242
+ */
2243
+ FirstRow = 0,
2244
+ /**
2245
+ * Column name (such as A,B,C...) as header of the table.
2246
+ */
2247
+ ColumnHeader = 1,
2248
+ /**
2249
+ * An empty header row.
2250
+ */
2251
+ Empty = 2,
2252
+ }
2253
+
2184
2254
  /**
2185
2255
  * Represents a list of pivot area.
2186
2256
  */
@@ -6076,6 +6146,16 @@ export class FontConfigs {
6076
6146
  * true if font is available, otherwise false.
6077
6147
  */
6078
6148
  static isFontAvailable(fontName: string) : boolean;
6149
+ /**
6150
+ * Get data infomation of font file data.
6151
+ * @param fontName - font name
6152
+ * @param isBold - the font style is bold or not
6153
+ * @param isItalic - the font style is italic or not
6154
+ * @param isExactStyle - whether to match the given bold/italic style exactly
6155
+ * @returns
6156
+ * Data infomation of font file data.
6157
+ */
6158
+ static getFontFileDataInfo(fontName: string, isBold: boolean, isItalic: boolean, isExactStyle: boolean) : FontFileDataInfo;
6079
6159
  /**
6080
6160
  * Font substitute names for given original font name.
6081
6161
  * @param originalFontName - Original font name.
@@ -8104,17 +8184,61 @@ export class Cell {
8104
8184
  */
8105
8185
  getHeightOfValue() : number;
8106
8186
  /**
8107
- * Gets the display style of the cell.
8108
- * If this cell is also affected by other settings such as conditional formatting, list objects, etc.,
8109
- * then the display style may be different from cell.GetStyle().
8187
+ * Gets the display style of this cell.
8188
+ * @returns
8189
+ * display style of this cell
8190
+ *
8191
+ * @remarks
8192
+ * Same with using <see cref="BorderType.SideBorders"/>
8193
+ * for <see cref="GetDisplayStyle(BorderType)"/>.
8194
+ * That is, this method will check and adjust top/bottom/left/right borders of this cell
8195
+ * according to the style(<see cref="GetStyle()"/>) of its adjacent cells,
8196
+ * but do not check the merged cells, and do not check the display style of adjacent cells.
8110
8197
  */
8111
8198
  getDisplayStyle() : Style;
8112
8199
  /**
8113
- * Gets the display style of the cell.
8114
- * If the cell is conditional formatted, the display style is not same as the cell.GetStyle().
8115
- * @param includeMergedBorders - Indicates whether checking borders of the merged cells.
8200
+ * Gets the display style of this cell.
8201
+ * @param includeMergedBorders - Indicates whether checking borders of merged cells.
8202
+ * @returns
8203
+ * display style of this cell
8204
+ *
8205
+ * @remarks
8206
+ * If the specified flag is false, then it is same with <see cref="GetDisplayStyle()"/>.
8207
+ * Otherwise it is same with using
8208
+ * <see cref="BorderType.SideBorders"/>|<see cref="BorderType.DynamicStyleBorders"/>
8209
+ * for <see cref="GetDisplayStyle(BorderType)"/>.
8116
8210
  */
8117
8211
  getDisplayStyle(includeMergedBorders: boolean) : Style;
8212
+ /**
8213
+ * Gets the display style of this cell.
8214
+ * @param adjacentBorders - Indicates which borders need to be checked and adjusted /// according to the borders of adjacent cells.
8215
+ * @returns
8216
+ * display style of this cell
8217
+ *
8218
+ * @remarks
8219
+ * If this cell is also affected by other settings such as conditional formatting, list objects, etc.,
8220
+ * then the display style may be different from <see cref="GetStyle()"/>.
8221
+ * <br>For flags of adjusting borders according to adjacent cells,
8222
+ * <see cref="BorderType.TopBorder"/>/<see cref="BorderType.BottomBorder"/>
8223
+ * <see cref="BorderType.LeftBorder"/>/<see cref="BorderType.RightBorder"/>
8224
+ * denote whether check and combine the bottom/top/right/left borders of
8225
+ * the left/right/top/bottom cells adjacent to this one.</br>
8226
+ * <br>For performance and compatibility consideration,
8227
+ * some enums are used to denote some special operations:</br>
8228
+ * <br><see cref="BorderType.Horizontal"/>/<see cref="BorderType.Vertical"/>
8229
+ * denote whether check and combine the bottom/right border of merged cells to this one.</br>
8230
+ * <br><see cref="BorderType.Diagonal"/>(that is, both <see cref="StyleModifyFlag.DiagonalUpBorder"/> and
8231
+ * <see cref="StyleModifyFlag.DiagonalDownBorder"/> have been set) denotes check and combine borders
8232
+ * from the display style of adjacent cells.</br>
8233
+ * <br>Please note, checking borders/styles of adjacent cells, especially the display styles,
8234
+ * is time-consumed process. If there is no need to get the borders for the returned style,
8235
+ * using <see cref="BorderType.None"/> to disable the process of adjacent cells
8236
+ * will give better performance.
8237
+ * When getting borders of adjacent cells from styles defined on those cells only(without setting
8238
+ * <see cref="BorderType.Diagonal"/>), the performance also may be better because checking
8239
+ * the display style of one cell is time-consumed too.</br>
8240
+ */
8241
+ getDisplayStyle(adjacentBorders: BorderType) : Style;
8118
8242
  /**
8119
8243
  * Gets format conditions which applies to this cell.
8120
8244
  * @returns
@@ -9860,8 +9984,42 @@ export class Cells {
9860
9984
  * @param column - column
9861
9985
  * @returns
9862
9986
  * the style of given cell.
9987
+ *
9988
+ * @remarks
9989
+ * The returned style is only the one set for the cell or inherited from the row/column of the cell,
9990
+ * does not include the applied properties by other settings such as conditional formattings.
9863
9991
  */
9864
9992
  getCellStyle(row: number, column: number) : Style;
9993
+ /**
9994
+ * Get the display style of given cell.
9995
+ * @param row - row index of given cell
9996
+ * @param column - column of given cell
9997
+ * @returns
9998
+ * the display style of given cell.
9999
+ *
10000
+ * @remarks
10001
+ * Same with <see cref="Cell.GetDisplayStyle()"/>,
10002
+ * and same with using <see cref="BorderType.SideBorders"/>
10003
+ * for <see cref="GetCellDisplayStyle(int, int, BorderType)"/>.
10004
+ */
10005
+ getCellDisplayStyle(row: number, column: number) : Style;
10006
+ /**
10007
+ * Get the display style of given cell.
10008
+ * @param row - row index of given cell
10009
+ * @param column - column of given cell
10010
+ * @param adjacentBorders - Indicates which borders need to be checked and adjusted according to the borders of adjacent cells. /// Please see the description for the same parameter of /// <see cref="Cell.GetDisplayStyle(BorderType)"/>.
10011
+ * @returns
10012
+ * the display style of given cell.
10013
+ *
10014
+ * @remarks
10015
+ * If the cell is also affected by other settings such as conditional formatting, list objects, etc.,
10016
+ * then the display style may be different from <see cref="GetCellStyle(int, int)"/>.
10017
+ * And because those settings also may be applied to empty(non-existing) cells,
10018
+ * using this method can avoid the instantiation of those empty cells
10019
+ * so the performance will be better than getting the Cell instance from Cells
10020
+ * and then calling <see cref="Cell.GetDisplayStyle(BorderType)"/>.
10021
+ */
10022
+ getCellDisplayStyle(row: number, column: number, adjacentBorders: BorderType) : Style;
9865
10023
  /**
9866
10024
  * Checks whether the implementation object is null.
9867
10025
  */
@@ -11629,6 +11787,30 @@ export class MarkdownSaveOptions extends SaveOptions {
11629
11787
  * @param value - The value to set.
11630
11788
  */
11631
11789
  setLineSeparator(value: string) : void;
11790
+ /**
11791
+ * Gets and sets how set the header of the table.
11792
+ */
11793
+ getTableHeaderType() : MarkdownTableHeaderType;
11794
+ /**
11795
+ * Gets and sets how set the header of the table.
11796
+ * @param value - The value to set.
11797
+ */
11798
+ setTableHeaderType(value: MarkdownTableHeaderType) : void;
11799
+ /**
11800
+ * Gets or sets the sheets to render. Default is all visible sheets in the workbook: <see cref="Aspose.Cells.Rendering.SheetSet.Active"/>.
11801
+ *
11802
+ * @remarks
11803
+ * The set is ignored when it is used in <see cref="SheetRender"/>
11804
+ */
11805
+ getSheetSet() : SheetSet;
11806
+ /**
11807
+ * Gets or sets the sheets to render. Default is all visible sheets in the workbook: <see cref="Aspose.Cells.Rendering.SheetSet.Active"/>.
11808
+ * @param value - The value to set.
11809
+ *
11810
+ * @remarks
11811
+ * The set is ignored when it is used in <see cref="SheetRender"/>
11812
+ */
11813
+ setSheetSet(value: SheetSet) : void;
11632
11814
  /**
11633
11815
  * Checks whether the implementation object is null.
11634
11816
  */
@@ -26853,6 +27035,10 @@ export class VbaModule {
26853
27035
  * Gets the type of module.
26854
27036
  */
26855
27037
  getType() : VbaModuleType;
27038
+ /**
27039
+ * Gets and sets the binary codes of module.
27040
+ */
27041
+ getBinaryCodes() : number[];
26856
27042
  /**
26857
27043
  * Gets and sets the codes of module.
26858
27044
  */
@@ -37678,9 +37864,11 @@ export class PlotArea extends ChartFrame {
37678
37864
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37679
37865
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37680
37866
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37681
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37682
- * <b>InnerHeight</b> properties.</p>
37867
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37868
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37683
37869
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37870
+ * @deprecated
37871
+ * Use PlotArea.XRatioToChart property, instead.
37684
37872
  */
37685
37873
  getX() : number;
37686
37874
  /**
@@ -37692,9 +37880,11 @@ export class PlotArea extends ChartFrame {
37692
37880
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37693
37881
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37694
37882
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37695
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37696
- * <b>InnerHeight</b> properties.</p>
37883
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37884
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37697
37885
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37886
+ * @deprecated
37887
+ * Use PlotArea.XRatioToChart property, instead.
37698
37888
  */
37699
37889
  setX(value: number) : void;
37700
37890
  /**
@@ -37705,9 +37895,11 @@ export class PlotArea extends ChartFrame {
37705
37895
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37706
37896
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37707
37897
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37708
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37709
- * <b>InnerHeight</b> properties.</p>
37898
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37899
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37710
37900
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37901
+ * @deprecated
37902
+ * Use PlotArea.YRatioToChart property, instead.
37711
37903
  */
37712
37904
  getY() : number;
37713
37905
  /**
@@ -37719,9 +37911,11 @@ export class PlotArea extends ChartFrame {
37719
37911
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37720
37912
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37721
37913
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37722
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37723
- * <b>InnerHeight</b> properties.</p>
37914
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37915
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37724
37916
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37917
+ * @deprecated
37918
+ * Use PlotArea.YRatioToChart property, instead.
37725
37919
  */
37726
37920
  setY(value: number) : void;
37727
37921
  /**
@@ -37732,9 +37926,11 @@ export class PlotArea extends ChartFrame {
37732
37926
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37733
37927
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37734
37928
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37735
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37736
- * <b>InnerHeight</b> properties.</p>
37929
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37930
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37737
37931
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37932
+ * @deprecated
37933
+ * Use PlotArea.HeightRatioToChart property, instead.
37738
37934
  */
37739
37935
  getHeight() : number;
37740
37936
  /**
@@ -37746,9 +37942,11 @@ export class PlotArea extends ChartFrame {
37746
37942
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37747
37943
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37748
37944
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37749
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37750
- * <b>InnerHeight</b> properties.</p>
37945
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37946
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37751
37947
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37948
+ * @deprecated
37949
+ * Use PlotArea.HeightRatioToChart property, instead.
37752
37950
  */
37753
37951
  setHeight(value: number) : void;
37754
37952
  /**
@@ -37759,9 +37957,11 @@ export class PlotArea extends ChartFrame {
37759
37957
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37760
37958
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37761
37959
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37762
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37763
- * <b>InnerHeight</b> properties.</p>
37960
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37961
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37764
37962
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37963
+ * @deprecated
37964
+ * Use PlotArea.WidthRatioToChart property, instead.
37765
37965
  */
37766
37966
  getWidth() : number;
37767
37967
  /**
@@ -37773,9 +37973,11 @@ export class PlotArea extends ChartFrame {
37773
37973
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37774
37974
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37775
37975
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37776
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37777
- * <b>InnerHeight</b> properties.</p>
37976
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37977
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37778
37978
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37979
+ * @deprecated
37980
+ * Use PlotArea.WidthRatioToChart property, instead.
37779
37981
  */
37780
37982
  setWidth(value: number) : void;
37781
37983
  /**
@@ -37786,9 +37988,11 @@ export class PlotArea extends ChartFrame {
37786
37988
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37787
37989
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37788
37990
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37789
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37790
- * <b>InnerHeight</b> properties.</p>
37991
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
37992
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37791
37993
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
37994
+ * @deprecated
37995
+ * Use PlotArea.InnerXRatioToChart property, instead.
37792
37996
  */
37793
37997
  getInnerX() : number;
37794
37998
  /**
@@ -37800,9 +38004,11 @@ export class PlotArea extends ChartFrame {
37800
38004
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37801
38005
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37802
38006
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37803
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37804
- * <b>InnerHeight</b> properties.</p>
38007
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38008
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37805
38009
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38010
+ * @deprecated
38011
+ * Use PlotArea.InnerXRatioToChart property, instead.
37806
38012
  */
37807
38013
  setInnerX(value: number) : void;
37808
38014
  /**
@@ -37813,9 +38019,11 @@ export class PlotArea extends ChartFrame {
37813
38019
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37814
38020
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37815
38021
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37816
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37817
- * <b>InnerHeight</b> properties.</p>
38022
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38023
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37818
38024
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38025
+ * @deprecated
38026
+ * Use PlotArea.InnerYRatioToChart property, instead.
37819
38027
  */
37820
38028
  getInnerY() : number;
37821
38029
  /**
@@ -37827,9 +38035,11 @@ export class PlotArea extends ChartFrame {
37827
38035
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37828
38036
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37829
38037
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37830
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37831
- * <b>InnerHeight</b> properties.</p>
38038
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38039
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37832
38040
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38041
+ * @deprecated
38042
+ * Use PlotArea.InnerYRatioToChart property, instead.
37833
38043
  */
37834
38044
  setInnerY(value: number) : void;
37835
38045
  /**
@@ -37840,9 +38050,11 @@ export class PlotArea extends ChartFrame {
37840
38050
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37841
38051
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37842
38052
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37843
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37844
- * <b>InnerHeight</b> properties.</p>
38053
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38054
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37845
38055
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38056
+ * @deprecated
38057
+ * Use PlotArea.InnerHeightRatioToChart property, instead.
37846
38058
  */
37847
38059
  getInnerHeight() : number;
37848
38060
  /**
@@ -37854,9 +38066,11 @@ export class PlotArea extends ChartFrame {
37854
38066
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37855
38067
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37856
38068
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37857
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37858
- * <b>InnerHeight</b> properties.</p>
38069
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38070
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37859
38071
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38072
+ * @deprecated
38073
+ * Use PlotArea.InnerHeightRatioToChart property, instead.
37860
38074
  */
37861
38075
  setInnerHeight(value: number) : void;
37862
38076
  /**
@@ -37867,9 +38081,11 @@ export class PlotArea extends ChartFrame {
37867
38081
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37868
38082
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37869
38083
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37870
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37871
- * <b>InnerHeight</b> properties.</p>
38084
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38085
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37872
38086
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38087
+ * @deprecated
38088
+ * Use PlotArea.InnerWidthRatioToChart property, instead.
37873
38089
  */
37874
38090
  getInnerWidth() : number;
37875
38091
  /**
@@ -37881,11 +38097,245 @@ export class PlotArea extends ChartFrame {
37881
38097
  * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
37882
38098
  * <p>The <b>X</b>, <b>Y</b>, <b>Width</b> and <b>Height</b> of <b>PlotArea</b> represents the plot-area
37883
38099
  * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
37884
- * If you want to get actual size of plot area, you should call <b>InnerX</b>, <b>InnerY</b>, <b>InnerWidth</b> and
37885
- * <b>InnerHeight</b> properties.</p>
38100
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38101
+ * <b>InnerHeightRatioToChart</b> properties.</p>
37886
38102
  * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38103
+ * @deprecated
38104
+ * Use PlotArea.InnerWidthRatioToChart property, instead.
37887
38105
  */
37888
38106
  setInnerWidth(value: number) : void;
38107
+ /**
38108
+ * Gets or gets the x coordinate of the upper left corner of plot-area bounding box in units of ratio of the chart area.
38109
+ *
38110
+ * @remarks
38111
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38112
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38113
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38114
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38115
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38116
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38117
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38118
+ * XPixel = XRatioToChart * chart.ChartObject.Width.
38119
+ */
38120
+ getXRatioToChart() : number;
38121
+ /**
38122
+ * Gets or gets the x coordinate of the upper left corner of plot-area bounding box in units of ratio of the chart area.
38123
+ * @param value - The value to set.
38124
+ *
38125
+ * @remarks
38126
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38127
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38128
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38129
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38130
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38131
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38132
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38133
+ * XPixel = XRatioToChart * chart.ChartObject.Width.
38134
+ */
38135
+ setXRatioToChart(value: number) : void;
38136
+ /**
38137
+ * Gets or gets the y coordinate of the upper top corner of plot-area bounding box in units of ratio of the chart area.
38138
+ *
38139
+ * @remarks
38140
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38141
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38142
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38143
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38144
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38145
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38146
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38147
+ * YPixel = YRatioToChart * chart.ChartObject.Width.
38148
+ */
38149
+ getYRatioToChart() : number;
38150
+ /**
38151
+ * Gets or gets the y coordinate of the upper top corner of plot-area bounding box in units of ratio of the chart area.
38152
+ * @param value - The value to set.
38153
+ *
38154
+ * @remarks
38155
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38156
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38157
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38158
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38159
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38160
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38161
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38162
+ * YPixel = YRatioToChart * chart.ChartObject.Width.
38163
+ */
38164
+ setYRatioToChart(value: number) : void;
38165
+ /**
38166
+ * Gets or sets the height of plot-area bounding box in units of ratio of the chart area.
38167
+ *
38168
+ * @remarks
38169
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38170
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38171
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38172
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38173
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38174
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38175
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38176
+ * HeightPixel = HeightRatioToChart * chart.ChartObject.Width.
38177
+ */
38178
+ getHeightRatioToChart() : number;
38179
+ /**
38180
+ * Gets or sets the height of plot-area bounding box in units of ratio of the chart area.
38181
+ * @param value - The value to set.
38182
+ *
38183
+ * @remarks
38184
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38185
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38186
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38187
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38188
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38189
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38190
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38191
+ * HeightPixel = HeightRatioToChart * chart.ChartObject.Width.
38192
+ */
38193
+ setHeightRatioToChart(value: number) : void;
38194
+ /**
38195
+ * Gets or sets the width of plot-area bounding box in units of ratio of the chart area.
38196
+ *
38197
+ * @remarks
38198
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38199
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38200
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38201
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38202
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38203
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38204
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38205
+ * WidthPixel = WidthRatioToChart * chart.ChartObject.Width.
38206
+ */
38207
+ getWidthRatioToChart() : number;
38208
+ /**
38209
+ * Gets or sets the width of plot-area bounding box in units of ratio of the chart area.
38210
+ * @param value - The value to set.
38211
+ *
38212
+ * @remarks
38213
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38214
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38215
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38216
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38217
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38218
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38219
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38220
+ * WidthPixel = WidthRatioToChart * chart.ChartObject.Width.
38221
+ */
38222
+ setWidthRatioToChart(value: number) : void;
38223
+ /**
38224
+ * Gets or gets the x coordinate of the upper top corner of plot area in units of ratio of the chart area.
38225
+ *
38226
+ * @remarks
38227
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38228
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38229
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38230
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38231
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38232
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38233
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38234
+ * InnerX in Pixel = InnerXRatioToChart * chart.ChartObject.Width.
38235
+ */
38236
+ getInnerXRatioToChart() : number;
38237
+ /**
38238
+ * Gets or gets the x coordinate of the upper top corner of plot area in units of ratio of the chart area.
38239
+ * @param value - The value to set.
38240
+ *
38241
+ * @remarks
38242
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38243
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38244
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38245
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38246
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38247
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38248
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38249
+ * InnerX in Pixel = InnerXRatioToChart * chart.ChartObject.Width.
38250
+ */
38251
+ setInnerXRatioToChart(value: number) : void;
38252
+ /**
38253
+ * Gets or gets the x coordinate of the upper top corner of plot area in units of ratio of the chart area.
38254
+ *
38255
+ * @remarks
38256
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38257
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38258
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38259
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38260
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38261
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38262
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38263
+ * InnerY in Pixel = InnerYRatioToChart * chart.ChartObject.Width.
38264
+ */
38265
+ getInnerYRatioToChart() : number;
38266
+ /**
38267
+ * Gets or gets the x coordinate of the upper top corner of plot area in units of ratio of the chart area.
38268
+ * @param value - The value to set.
38269
+ *
38270
+ * @remarks
38271
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38272
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38273
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38274
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38275
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38276
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38277
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38278
+ * InnerY in Pixel = InnerYRatioToChart * chart.ChartObject.Width.
38279
+ */
38280
+ setInnerYRatioToChart(value: number) : void;
38281
+ /**
38282
+ * Gets or sets the height of plot area in units of ratio of the chart area.
38283
+ *
38284
+ * @remarks
38285
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38286
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38287
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38288
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38289
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38290
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38291
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38292
+ * InnerHeight in Pixel = InnerXRatioToChart * chart.ChartObject.Width.
38293
+ */
38294
+ getInnerHeightRatioToChart() : number;
38295
+ /**
38296
+ * Gets or sets the height of plot area in units of ratio of the chart area.
38297
+ * @param value - The value to set.
38298
+ *
38299
+ * @remarks
38300
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38301
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38302
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38303
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38304
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38305
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38306
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38307
+ * InnerHeight in Pixel = InnerXRatioToChart * chart.ChartObject.Width.
38308
+ */
38309
+ setInnerHeightRatioToChart(value: number) : void;
38310
+ /**
38311
+ * Gets or sets the width of plot area in units of ratio of the chart area.
38312
+ *
38313
+ * @remarks
38314
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38315
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38316
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38317
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38318
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38319
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38320
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38321
+ * InnerWidth in Pixel = InnerXRatioToChart * chart.ChartObject.Width.
38322
+ */
38323
+ getInnerWidthRatioToChart() : number;
38324
+ /**
38325
+ * Gets or sets the width of plot area in units of ratio of the chart area.
38326
+ * @param value - The value to set.
38327
+ *
38328
+ * @remarks
38329
+ * <p>The plot-area bounding box includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38330
+ * If the value is not created by MS Excel, please call Chart.Calculate() method before calling this method. </p>
38331
+ * <p>The <b>XRatioToChart</b>, <b>YRatioToChart</b>, <b>WidthRatioToChart</b> and <b>HeightRatioToChart</b> of <b>PlotArea</b> represents the plot-area
38332
+ * bounding box that includes the plot area, tick marks(tick labels), and a small border around the tick marks.
38333
+ * If you want to get actual size of plot area, you should call <b>InnerXRatioToChart</b>, <b>InnerYRatioToChart</b>, <b>InnerWidthRatioToChart</b> and
38334
+ * <b>InnerHeightRatioToChart</b> properties.</p>
38335
+ * <p>For excel 2007 or latter, the default value is zero. you should call get the value after calling Chart.Calculate().</p>
38336
+ * InnerWidth in Pixel = InnerXRatioToChart * chart.ChartObject.Width.
38337
+ */
38338
+ setInnerWidthRatioToChart(value: number) : void;
37889
38339
  /**
37890
38340
  * Indicates whether the plot area is automatic sized.
37891
38341
  */
@@ -37998,29 +38448,37 @@ export enum LookAtType {
37998
38448
  */
37999
38449
  export enum LookInType {
38000
38450
  /**
38001
- * If the cell contains a formula, find object from formula, else find it from the value.
38451
+ * Finds the searched object from formula(<see cref="Cell.Formula"/>) if the cell is formula,
38452
+ * otherwise finds from cell's original value(same with <see cref="OriginalValues"/>).
38002
38453
  */
38003
38454
  Formulas = 0,
38004
38455
  /**
38005
- * Only find object from the formatted values.
38456
+ * Finds object from cell's original value(<see cref="Cell.Value"/>)
38457
+ * and formatted value(<see cref="Cell.StringValue"/>).
38006
38458
  */
38007
38459
  Values = 1,
38008
38460
  /**
38009
- * Only find object from the values of cells which do not contains formula.
38461
+ * Ignores cells that are formula. For those cells that are not formula,
38462
+ * it is same with <see cref="Values"/>.
38010
38463
  */
38011
38464
  ValuesExcludeFormulaCell = 2,
38012
38465
  /**
38013
- * Only find object from the comments.
38466
+ * Finds object from cell's comment only. Ignores those cells that have no comment.
38014
38467
  */
38015
38468
  Comments = 3,
38016
38469
  /**
38017
- * Only find object from formulas.
38470
+ * Ignores cells that are not formula. For those cells that are formula,
38471
+ * finds the searched object from formula(<see cref="Cell.Formula"/>).
38018
38472
  */
38019
38473
  OnlyFormulas = 4,
38020
38474
  /**
38021
- * Only find object from the original values.
38475
+ * Find object from cell's original value only.
38022
38476
  */
38023
38477
  OriginalValues = 5,
38478
+ /**
38479
+ * Find object from cell's formatted value(<see cref="Cell.StringValue"/>) only.
38480
+ */
38481
+ FormattedValues = 6,
38024
38482
  }
38025
38483
 
38026
38484
  /**
@@ -38727,11 +39185,27 @@ export class FindOptions {
38727
39185
  setCaseSensitive(value: boolean) : void;
38728
39186
  /**
38729
39187
  * Look at type.
39188
+ *
39189
+ * @remarks
39190
+ * When <see cref="RegexKey"/> is true and user has specified the exact rule for the regex,
39191
+ * for performance consideration this property should be set as <see cref="LookAtType.EntireContent"/>.
39192
+ * Otherwise we will refactor the search key to ensure it can be matched according to the specific type.
39193
+ * For example, when the type is <see cref="LookAtType.Contains"/>(this is the default value for this property),
39194
+ * we will add wildcards at the beginning and end of the search key automatically.
39195
+ * In this case, the regular expressions will become more complex and the performance will also decrease.
38730
39196
  */
38731
39197
  getLookAtType() : LookAtType;
38732
39198
  /**
38733
39199
  * Look at type.
38734
39200
  * @param value - The value to set.
39201
+ *
39202
+ * @remarks
39203
+ * When <see cref="RegexKey"/> is true and user has specified the exact rule for the regex,
39204
+ * for performance consideration this property should be set as <see cref="LookAtType.EntireContent"/>.
39205
+ * Otherwise we will refactor the search key to ensure it can be matched according to the specific type.
39206
+ * For example, when the type is <see cref="LookAtType.Contains"/>(this is the default value for this property),
39207
+ * we will add wildcards at the beginning and end of the search key automatically.
39208
+ * In this case, the regular expressions will become more complex and the performance will also decrease.
38735
39209
  */
38736
39210
  setLookAtType(value: LookAtType) : void;
38737
39211
  /**
@@ -38767,13 +39241,37 @@ export class FindOptions {
38767
39241
  setLookInType(value: LookInType) : void;
38768
39242
  /**
38769
39243
  * Indicates whether the searched key is regex.
38770
- * If true the searched key will be taken as regex and parsed. Otherwise the key will be parsed according to the rules in ms excel.
39244
+ * If true the searched key will be taken as regex and parsed.
39245
+ * Otherwise the key will be parsed according to the rules in ms excel.
39246
+ *
39247
+ * @remarks
39248
+ * Even though the search key has been specified as regex,
39249
+ * it may be refactored according to specified <see cref="LookAtType"/>.
39250
+ * For example, when the type is <see cref="LookAtType.Contains"/>(this is the default value for this options),
39251
+ * wildcards will be added at the beginning and end of the search key automatically to ensure the match will be
39252
+ * checked as "contains". In this case, the regular expressions will become more complex
39253
+ * and the performance will also decrease.
39254
+ * So, for performance consideration, if user has specified the exact rule for the regex, then there is no need to
39255
+ * use <see cref="LookAtType"/> as additional constraint and user may set it as <see cref="LookAtType.EntireContent"/>
39256
+ * to get better performance.
38771
39257
  */
38772
39258
  getRegexKey() : boolean;
38773
39259
  /**
38774
39260
  * Indicates whether the searched key is regex.
38775
- * If true the searched key will be taken as regex and parsed. Otherwise the key will be parsed according to the rules in ms excel.
39261
+ * If true the searched key will be taken as regex and parsed.
39262
+ * Otherwise the key will be parsed according to the rules in ms excel.
38776
39263
  * @param value - The value to set.
39264
+ *
39265
+ * @remarks
39266
+ * Even though the search key has been specified as regex,
39267
+ * it may be refactored according to specified <see cref="LookAtType"/>.
39268
+ * For example, when the type is <see cref="LookAtType.Contains"/>(this is the default value for this options),
39269
+ * wildcards will be added at the beginning and end of the search key automatically to ensure the match will be
39270
+ * checked as "contains". In this case, the regular expressions will become more complex
39271
+ * and the performance will also decrease.
39272
+ * So, for performance consideration, if user has specified the exact rule for the regex, then there is no need to
39273
+ * use <see cref="LookAtType"/> as additional constraint and user may set it as <see cref="LookAtType.EntireContent"/>
39274
+ * to get better performance.
38777
39275
  */
38778
39276
  setRegexKey(value: boolean) : void;
38779
39277
  /**
@@ -39897,11 +40395,11 @@ export class Axis {
39897
40395
  *
39898
40396
  * @remarks
39899
40397
  * NOTE: This property is now obsolete. Instead,
39900
- * please use Axis.CoustomDisplayUnit property.
40398
+ * please use Axis.CustomDisplayUnit property.
39901
40399
  * This property will be removed 12 months later since February 2025.
39902
40400
  * Aspose apologizes for any inconvenience you may have experienced.
39903
40401
  * @deprecated
39904
- * Use Axis.CoustomDisplayUnit property, instead.
40402
+ * Use Axis.CustomDisplayUnit property, instead.
39905
40403
  */
39906
40404
  getCustomUnit() : number;
39907
40405
  /**
@@ -39910,22 +40408,22 @@ export class Axis {
39910
40408
  *
39911
40409
  * @remarks
39912
40410
  * NOTE: This property is now obsolete. Instead,
39913
- * please use Axis.CoustomDisplayUnit property.
40411
+ * please use Axis.CustomDisplayUnit property.
39914
40412
  * This property will be removed 12 months later since February 2025.
39915
40413
  * Aspose apologizes for any inconvenience you may have experienced.
39916
40414
  * @deprecated
39917
- * Use Axis.CoustomDisplayUnit property, instead.
40415
+ * Use Axis.CustomDisplayUnit property, instead.
39918
40416
  */
39919
40417
  setCustomUnit(value: number) : void;
39920
40418
  /**
39921
40419
  * Specifies a custom value for the display unit.
39922
40420
  */
39923
- getCoustomDisplayUnit() : number;
40421
+ getCustomDisplayUnit() : number;
39924
40422
  /**
39925
40423
  * Specifies a custom value for the display unit.
39926
40424
  * @param value - The value to set.
39927
40425
  */
39928
- setCoustomDisplayUnit(value: number) : void;
40426
+ setCustomDisplayUnit(value: number) : void;
39929
40427
  /**
39930
40428
  * Represents a unit label on an axis in the specified chart.
39931
40429
  * Unit labels are useful for charting large values— for example, in the millions or billions.
@@ -40263,6 +40761,18 @@ export class BorderCollection {
40263
40761
  * Enumerates the border line and diagonal line types.
40264
40762
  */
40265
40763
  export enum BorderType {
40764
+ /**
40765
+ * Represents left border line.
40766
+ */
40767
+ LeftBorder = 1,
40768
+ /**
40769
+ * Represents right border line exists.
40770
+ */
40771
+ RightBorder = 2,
40772
+ /**
40773
+ * Represents top border line.
40774
+ */
40775
+ TopBorder = 4,
40266
40776
  /**
40267
40777
  * Represents bottom border line.
40268
40778
  */
@@ -40276,25 +40786,46 @@ export enum BorderType {
40276
40786
  */
40277
40787
  DiagonalUp = 32,
40278
40788
  /**
40279
- * Represents left border line.
40789
+ * Only for dynamic style, such as conditional formatting.
40280
40790
  */
40281
- LeftBorder = 1,
40791
+ Vertical = 64,
40282
40792
  /**
40283
- * Represents right border line exists.
40793
+ * Only for dynamic style, such as conditional formatting.
40284
40794
  */
40285
- RightBorder = 2,
40795
+ Horizontal = 128,
40286
40796
  /**
40287
- * Represents top border line.
40797
+ * Indicates the four side borders: <see cref="LeftBorder"/>,
40798
+ * <see cref="RightBorder"/>, <see cref="TopBorder"/> and <see cref="BottomBorder"/>.
40799
+ *
40800
+ * @remarks
40801
+ * It is combination of multiple borders for user's convenience
40802
+ * and can only be used for some APIs that accept multiple border types.
40288
40803
  */
40289
- TopBorder = 4,
40804
+ SideBorders = 15,
40290
40805
  /**
40291
- * Only for dynamic style,such as conditional formatting.
40806
+ * Special combination of multiple borders for user's convenience for some APIs.
40807
+ * Indicates diagonal borders of <see cref="DiagonalUp"/> and <see cref="DiagonalDown"/>.
40808
+ *
40809
+ * @remarks
40810
+ * It is combination of multiple borders for user's convenience
40811
+ * and can only be used for some APIs that accept multiple border types.
40292
40812
  */
40293
- Horizontal = 128,
40813
+ Diagonal = 48,
40814
+ /**
40815
+ * Indicates <see cref="Vertical"/> and <see cref="Horizontal"/> of dynamic style.
40816
+ *
40817
+ * @remarks
40818
+ * It is combination of multiple borders for user's convenience
40819
+ * and can only be used for some APIs that accept multiple border types.
40820
+ */
40821
+ DynamicStyleBorders = 192,
40294
40822
  /**
40295
- * Only for dynamic style,such as conditional formatting.
40823
+ * No border has been specified.
40824
+ *
40825
+ * @remarks
40826
+ * It can only be used for some APIs that accept none or multiple border types.
40296
40827
  */
40297
- Vertical = 64,
40828
+ None = 0,
40298
40829
  }
40299
40830
 
40300
40831
  /**
@@ -40972,6 +41503,12 @@ export class Chart {
40972
41503
  *
40973
41504
  * @remarks
40974
41505
  * If the width or height is zero or the chart is not supported according to Supported Charts List, this method will do nothing.
41506
+ * NOTE: This method is now obsolete. Instead,
41507
+ * please use ToImage(string,ImageOrPrintOptions) method with specified quality.
41508
+ * This method will be removed 12 months later since March 2025.
41509
+ * Aspose apologizes for any inconvenience you may have experienced.
41510
+ * @deprecated
41511
+ * Use Chart.ToImage(string,ImageOrPrintOptions) method instead.
40975
41512
  */
40976
41513
  toImage(imageFile: string, jpegQuality: number) : void;
40977
41514
  /**
@@ -41058,6 +41595,12 @@ export class Chart {
41058
41595
  *
41059
41596
  * @remarks
41060
41597
  * If the width or height is zero or the chart is not supported according to Supported Charts List, this method will do nothing.
41598
+ * NOTE: This method is now obsolete. Instead,
41599
+ * please use ToImage(string,ImageOrPrintOptions) method with specified quality.
41600
+ * This method will be removed 12 months later since March 2025.
41601
+ * Aspose apologizes for any inconvenience you may have experienced.
41602
+ * @deprecated
41603
+ * Use Chart.ToImage(string,ImageOrPrintOptions) method instead.
41061
41604
  */
41062
41605
  toImageAsync(imageFile: string, jpegQuality: number) : Promise<void>;
41063
41606
  /**
@@ -41223,41 +41766,149 @@ export class ChartArea extends ChartFrame {
41223
41766
  */
41224
41767
  constructor(obj: ChartFrame);
41225
41768
  /**
41226
- * Gets or gets the horizontal offset from its upper left corner column.
41769
+ * Gets or gets the horizontal offset from its upper left corner column, in units of 1/4000 of the chart area.
41770
+ *
41771
+ * @remarks
41772
+ * NOTE: This member is now obsolete.
41773
+ * Please use ChartArea.XRatioToChart property, instead.
41774
+ * X = XRatioToChart * 4000.
41775
+ * This property will be removed 12 months later since February 2025.
41776
+ * Aspose apologizes for any inconvenience you may have experienced.
41777
+ * @deprecated
41778
+ * Use ChartArea.XRatioToChart property, instead.
41227
41779
  */
41228
41780
  getX() : number;
41229
41781
  /**
41230
- * Gets or gets the horizontal offset from its upper left corner column.
41782
+ * Gets or gets the horizontal offset from its upper left corner column, in units of 1/4000 of the chart area.
41231
41783
  * @param value - The value to set.
41784
+ *
41785
+ * @remarks
41786
+ * NOTE: This member is now obsolete.
41787
+ * Please use ChartArea.XRatioToChart property, instead.
41788
+ * X = XRatioToChart * 4000.
41789
+ * This property will be removed 12 months later since February 2025.
41790
+ * Aspose apologizes for any inconvenience you may have experienced.
41791
+ * @deprecated
41792
+ * Use ChartArea.XRatioToChart property, instead.
41232
41793
  */
41233
41794
  setX(value: number) : void;
41234
41795
  /**
41235
- * Gets or gets the vertical offset from its upper left corner row.
41796
+ * Gets or gets the vertical offset from its upper left corner row, in units of 1/4000 of the chart area.
41797
+ *
41798
+ * @remarks
41799
+ * NOTE: This member is now obsolete.
41800
+ * Please use ChartArea.YRatioToChart property, instead.
41801
+ * Y = YRatioToChart * 4000;
41802
+ * This property will be removed 12 months later since February 2025.
41803
+ * Aspose apologizes for any inconvenience you may have experienced.
41804
+ * @deprecated
41805
+ * Use ChartArea.YRatioToChart property, instead.
41236
41806
  */
41237
41807
  getY() : number;
41238
41808
  /**
41239
- * Gets or gets the vertical offset from its upper left corner row.
41809
+ * Gets or gets the vertical offset from its upper left corner row, in units of 1/4000 of the chart area.
41240
41810
  * @param value - The value to set.
41811
+ *
41812
+ * @remarks
41813
+ * NOTE: This member is now obsolete.
41814
+ * Please use ChartArea.YRatioToChart property, instead.
41815
+ * Y = YRatioToChart * 4000;
41816
+ * This property will be removed 12 months later since February 2025.
41817
+ * Aspose apologizes for any inconvenience you may have experienced.
41818
+ * @deprecated
41819
+ * Use ChartArea.YRatioToChart property, instead.
41241
41820
  */
41242
41821
  setY(value: number) : void;
41243
41822
  /**
41244
- * Gets or sets the vertical offset from its lower right corner row.
41823
+ * Gets or sets the vertical offset from its lower right corner row, in units of 1/4000 of the chart area.
41824
+ *
41825
+ * @remarks
41826
+ * NOTE: This member is now obsolete.
41827
+ * Please use ChartArea.HeightRatioToChart property, instead.
41828
+ * Height = HeightRatioToChart * 4000.
41829
+ * This property will be removed 12 months later since February 2025.
41830
+ * Aspose apologizes for any inconvenience you may have experienced.
41831
+ * @deprecated
41832
+ * Use ChartArea.HeightRatioToChart property, instead.
41245
41833
  */
41246
41834
  getHeight() : number;
41247
41835
  /**
41248
- * Gets or sets the vertical offset from its lower right corner row.
41836
+ * Gets or sets the vertical offset from its lower right corner row, in units of 1/4000 of the chart area.
41249
41837
  * @param value - The value to set.
41838
+ *
41839
+ * @remarks
41840
+ * NOTE: This member is now obsolete.
41841
+ * Please use ChartArea.HeightRatioToChart property, instead.
41842
+ * Height = HeightRatioToChart * 4000.
41843
+ * This property will be removed 12 months later since February 2025.
41844
+ * Aspose apologizes for any inconvenience you may have experienced.
41845
+ * @deprecated
41846
+ * Use ChartArea.HeightRatioToChart property, instead.
41250
41847
  */
41251
41848
  setHeight(value: number) : void;
41252
41849
  /**
41253
- * Gets or sets the horizontal offset from its lower right corner column.
41850
+ * Gets or sets the horizontal offset from its lower right corner column, in units of 1/4000 of the chart area.
41851
+ *
41852
+ * @remarks
41853
+ * NOTE: This member is now obsolete.
41854
+ * Please use ChartArea.WidthRatioToChart property, instead.
41855
+ * Width = WidthRatioToChart * 4000.
41856
+ * This property will be removed 12 months later since February 2025.
41857
+ * Aspose apologizes for any inconvenience you may have experienced.
41858
+ * @deprecated
41859
+ * Use ChartArea.WidthRatioToChart property, instead.
41254
41860
  */
41255
41861
  getWidth() : number;
41256
41862
  /**
41257
- * Gets or sets the horizontal offset from its lower right corner column.
41863
+ * Gets or sets the horizontal offset from its lower right corner column, in units of 1/4000 of the chart area.
41258
41864
  * @param value - The value to set.
41865
+ *
41866
+ * @remarks
41867
+ * NOTE: This member is now obsolete.
41868
+ * Please use ChartArea.WidthRatioToChart property, instead.
41869
+ * Width = WidthRatioToChart * 4000.
41870
+ * This property will be removed 12 months later since February 2025.
41871
+ * Aspose apologizes for any inconvenience you may have experienced.
41872
+ * @deprecated
41873
+ * Use ChartArea.WidthRatioToChart property, instead.
41259
41874
  */
41260
41875
  setWidth(value: number) : void;
41876
+ /**
41877
+ * Gets or gets the horizontal offset from its upper left corner column, in units of ratio of the chart area.
41878
+ */
41879
+ getXRatioToChart() : number;
41880
+ /**
41881
+ * Gets or gets the horizontal offset from its upper left corner column, in units of ratio of the chart area.
41882
+ * @param value - The value to set.
41883
+ */
41884
+ setXRatioToChart(value: number) : void;
41885
+ /**
41886
+ * Gets or gets the vertical offset from its upper left corner row, in units of ratio of the chart area.
41887
+ */
41888
+ getYRatioToChart() : number;
41889
+ /**
41890
+ * Gets or gets the vertical offset from its upper left corner row, in units of ratio of the chart area.
41891
+ * @param value - The value to set.
41892
+ */
41893
+ setYRatioToChart(value: number) : void;
41894
+ /**
41895
+ * Gets or sets the vertical offset from its lower right corner row, in units of ratio of the chart area.
41896
+ */
41897
+ getHeightRatioToChart() : number;
41898
+ /**
41899
+ * Gets or sets the vertical offset from its lower right corner row, in units of ratio of the chart area.
41900
+ * @param value - The value to set.
41901
+ */
41902
+ setHeightRatioToChart(value: number) : void;
41903
+ /**
41904
+ * Gets or sets the horizontal offset from its lower right corner column, in units of ratio of the chart area.
41905
+ */
41906
+ getWidthRatioToChart() : number;
41907
+ /**
41908
+ * Gets or sets the horizontal offset from its lower right corner column, in units of ratio of the chart area.
41909
+ * @param value - The value to set.
41910
+ */
41911
+ setWidthRatioToChart(value: number) : void;
41261
41912
  /**
41262
41913
  * Gets a <see cref="Font"/> object of the specified chartarea object.
41263
41914
  */
@@ -41486,7 +42137,9 @@ export class ChartFrame {
41486
42137
  *
41487
42138
  * @remarks
41488
42139
  * How to convert units of 1/4000 to pixels?
41489
- * X In Pixels = X * Chart.ChartObject.Width / 4000;
42140
+ * X In Pixels = X * Chart.ChartObject.Width / 4000d;
42141
+ * @deprecated
42142
+ * Use ChartFrame.XRatioToChart property, instead.
41490
42143
  */
41491
42144
  getX() : number;
41492
42145
  /**
@@ -41495,7 +42148,9 @@ export class ChartFrame {
41495
42148
  *
41496
42149
  * @remarks
41497
42150
  * How to convert units of 1/4000 to pixels?
41498
- * X In Pixels = X * Chart.ChartObject.Width / 4000;
42151
+ * X In Pixels = X * Chart.ChartObject.Width / 4000d;
42152
+ * @deprecated
42153
+ * Use ChartFrame.XRatioToChart property, instead.
41499
42154
  */
41500
42155
  setX(value: number) : void;
41501
42156
  /**
@@ -41503,7 +42158,9 @@ export class ChartFrame {
41503
42158
  *
41504
42159
  * @remarks
41505
42160
  * How to convert units of 1/4000 to pixels?
41506
- * Y In Pixels = Y * Chart.ChartObject.Height / 4000;
42161
+ * Y In Pixels = Y * Chart.ChartObject.Height / 4000d;
42162
+ * @deprecated
42163
+ * Use ChartFrame.YRatioToChart property, instead.
41507
42164
  */
41508
42165
  getY() : number;
41509
42166
  /**
@@ -41512,7 +42169,9 @@ export class ChartFrame {
41512
42169
  *
41513
42170
  * @remarks
41514
42171
  * How to convert units of 1/4000 to pixels?
41515
- * Y In Pixels = Y * Chart.ChartObject.Height / 4000;
42172
+ * Y In Pixels = Y * Chart.ChartObject.Height / 4000d;
42173
+ * @deprecated
42174
+ * Use ChartFrame.YRatioToChart property, instead.
41516
42175
  */
41517
42176
  setY(value: number) : void;
41518
42177
  /**
@@ -41520,7 +42179,9 @@ export class ChartFrame {
41520
42179
  *
41521
42180
  * @remarks
41522
42181
  * How to convert units of 1/4000 to pixels?
41523
- * Height In Pixels = Y * Chart.ChartObject.Height / 4000;
42182
+ * Height In Pixels = Y * Chart.ChartObject.Height / 4000d;
42183
+ * @deprecated
42184
+ * Use ChartFrame.HeightRatioToChart property, instead.
41524
42185
  */
41525
42186
  getHeight() : number;
41526
42187
  /**
@@ -41529,7 +42190,9 @@ export class ChartFrame {
41529
42190
  *
41530
42191
  * @remarks
41531
42192
  * How to convert units of 1/4000 to pixels?
41532
- * Height In Pixels = Y * Chart.ChartObject.Height / 4000;
42193
+ * Height In Pixels = Y * Chart.ChartObject.Height / 4000d;
42194
+ * @deprecated
42195
+ * Use ChartFrame.HeightRatioToChart property, instead.
41533
42196
  */
41534
42197
  setHeight(value: number) : void;
41535
42198
  /**
@@ -41537,7 +42200,9 @@ export class ChartFrame {
41537
42200
  *
41538
42201
  * @remarks
41539
42202
  * How to convert units of 1/4000 to pixels?
41540
- * Width In Pixels = Width * Chart.ChartObject.Height / 4000;
42203
+ * Width In Pixels = Width * Chart.ChartObject.Height / 4000d;
42204
+ * @deprecated
42205
+ * Use ChartFrame.WidthRatioToChart property, instead.
41541
42206
  */
41542
42207
  getWidth() : number;
41543
42208
  /**
@@ -41546,7 +42211,9 @@ export class ChartFrame {
41546
42211
  *
41547
42212
  * @remarks
41548
42213
  * How to convert units of 1/4000 to pixels?
41549
- * Width In Pixels = Width * Chart.ChartObject.Height / 4000;
42214
+ * Width In Pixels = Width * Chart.ChartObject.Height / 4000d;
42215
+ * @deprecated
42216
+ * Use ChartFrame.WidthRatioToChart property, instead.
41550
42217
  */
41551
42218
  setWidth(value: number) : void;
41552
42219
  /**
@@ -41567,21 +42234,185 @@ export class ChartFrame {
41567
42234
  */
41568
42235
  isDefaultPosBeSet() : boolean;
41569
42236
  /**
41570
- * Represents x of default position
42237
+ * Represents x of default position in units of 1/4000 of the chart area.
42238
+ *
42239
+ * @remarks
42240
+ * NOTE: This member is now obsolete.
42241
+ * Please use ChartFrame.DefaultXRatioToChart property, instead.
42242
+ * DefaultX = (int)(DefaultXRatioToChart * 4000);
42243
+ * This property will be removed 12 months later since February 2025.
42244
+ * Aspose apologizes for any inconvenience you may have experienced.
42245
+ * @deprecated
42246
+ * Use ChartFrame.DefaultXRatioToChart property, instead.
41571
42247
  */
41572
42248
  getDefaultX() : number;
41573
42249
  /**
41574
- * Represents y of default position
42250
+ * Represents y of default position in units of 1/4000 of the chart area.
42251
+ *
42252
+ * @remarks
42253
+ * NOTE: This member is now obsolete.
42254
+ * Please use ChartFrame.DefaultYRatioToChart property, instead.
42255
+ * DefaultY = (int)(DefaultYRatioToChart * 4000);
42256
+ * This property will be removed 12 months later since February 2025.
42257
+ * Aspose apologizes for any inconvenience you may have experienced.
42258
+ * @deprecated
42259
+ * Use ChartFrame.DefaultYRatioToChart property, instead.
41575
42260
  */
41576
42261
  getDefaultY() : number;
41577
42262
  /**
41578
- * Represents width of default position
42263
+ * Represents width of default position in units of 1/4000 of the chart area.
42264
+ *
42265
+ * @remarks
42266
+ * NOTE: This member is now obsolete.
42267
+ * Please use ChartFrame.DefaultWidthRatioToChart property, instead.
42268
+ * DefaultWidth = (int)(DefaultWidthRatioToChart * 4000);
42269
+ * This property will be removed 12 months later since February 2025.
42270
+ * Aspose apologizes for any inconvenience you may have experienced.
42271
+ * @deprecated
42272
+ * Use ChartFrame.DefaultWidthRatioToChart property, instead.
41579
42273
  */
41580
42274
  getDefaultWidth() : number;
41581
42275
  /**
41582
- * Represents height of default position
42276
+ * Represents height of default position in units of 1/4000 of the chart area.
42277
+ *
42278
+ * @remarks
42279
+ * NOTE: This member is now obsolete.
42280
+ * Please use ChartFrame.DefaultHeightRatioToChart property, instead.
42281
+ * DefaultHeight = (int)(DefaultHeightRatioToChart * 4000);
42282
+ * This property will be removed 12 months later since February 2025.
42283
+ * Aspose apologizes for any inconvenience you may have experienced.
42284
+ * @deprecated
42285
+ * Use ChartFrame.DefaultHeightRatioToChart property, instead.
41583
42286
  */
41584
42287
  getDefaultHeight() : number;
42288
+ /**
42289
+ * Represents x of default position in units of Fraction of the chart area.
42290
+ */
42291
+ getDefaultXRatioToChart() : number;
42292
+ /**
42293
+ * Represents y of default position in units of Fraction of the chart area.
42294
+ */
42295
+ getDefaultYRatioToChart() : number;
42296
+ /**
42297
+ * Represents width of default position in units of Fraction of the chart area.
42298
+ */
42299
+ getDefaultWidthRatioToChart() : number;
42300
+ /**
42301
+ * Represents height of default position in units of Fraction of the chart area.
42302
+ */
42303
+ getDefaultHeightRatioToChart() : number;
42304
+ /**
42305
+ * Gets or sets the x coordinate of the upper left corner in units of ratio of the chart area.
42306
+ *
42307
+ * @remarks
42308
+ * This is a fraction value, its valid range is between 0-1.
42309
+ * How to convert units of ratio to pixels?
42310
+ * XPixel = XRatioToChart * Chart.ChartObject.Width;
42311
+ */
42312
+ getXRatioToChart() : number;
42313
+ /**
42314
+ * Gets or sets the x coordinate of the upper left corner in units of ratio of the chart area.
42315
+ * @param value - The value to set.
42316
+ *
42317
+ * @remarks
42318
+ * This is a fraction value, its valid range is between 0-1.
42319
+ * How to convert units of ratio to pixels?
42320
+ * XPixel = XRatioToChart * Chart.ChartObject.Width;
42321
+ */
42322
+ setXRatioToChart(value: number) : void;
42323
+ /**
42324
+ * Gets or sets the y coordinate of the upper left corner in units of ratio of the chart area.
42325
+ *
42326
+ * @remarks
42327
+ * This is a fraction value, its valid range is between 0-1.
42328
+ * How to convert units of ratio to pixels?
42329
+ * YPixel = YRatioToChart * Chart.ChartObject.Height;
42330
+ */
42331
+ getYRatioToChart() : number;
42332
+ /**
42333
+ * Gets or sets the y coordinate of the upper left corner in units of ratio of the chart area.
42334
+ * @param value - The value to set.
42335
+ *
42336
+ * @remarks
42337
+ * This is a fraction value, its valid range is between 0-1.
42338
+ * How to convert units of ratio to pixels?
42339
+ * YPixel = YRatioToChart * Chart.ChartObject.Height;
42340
+ */
42341
+ setYRatioToChart(value: number) : void;
42342
+ /**
42343
+ * Gets or sets the width of frame in units of ratio of the chart area.
42344
+ *
42345
+ * @remarks
42346
+ * This is a fraction value, its valid range is between 0-1.
42347
+ * How to convert units of ratio to pixels?
42348
+ * WidthPixel = WidthRatioToChart * Chart.ChartObject.Width;
42349
+ */
42350
+ getWidthRatioToChart() : number;
42351
+ /**
42352
+ * Gets or sets the width of frame in units of ratio of the chart area.
42353
+ * @param value - The value to set.
42354
+ *
42355
+ * @remarks
42356
+ * This is a fraction value, its valid range is between 0-1.
42357
+ * How to convert units of ratio to pixels?
42358
+ * WidthPixel = WidthRatioToChart * Chart.ChartObject.Width;
42359
+ */
42360
+ setWidthRatioToChart(value: number) : void;
42361
+ /**
42362
+ * Gets or sets the height of frame in units of ratio of the chart area.
42363
+ *
42364
+ * @remarks
42365
+ * This is a fraction value, its valid range is between 0-1.
42366
+ * How to convert units of ratio to pixels?
42367
+ * HeightPixel = HeightRatioToChart * Chart.ChartObject.Height;
42368
+ */
42369
+ getHeightRatioToChart() : number;
42370
+ /**
42371
+ * Gets or sets the height of frame in units of ratio of the chart area.
42372
+ * @param value - The value to set.
42373
+ *
42374
+ * @remarks
42375
+ * This is a fraction value, its valid range is between 0-1.
42376
+ * How to convert units of ratio to pixels?
42377
+ * HeightPixel = HeightRatioToChart * Chart.ChartObject.Height;
42378
+ */
42379
+ setHeightRatioToChart(value: number) : void;
42380
+ /**
42381
+ * Gets or sets the x coordinate of the upper left corner in units of Pixel.
42382
+ */
42383
+ getXPixel() : number;
42384
+ /**
42385
+ * Gets or sets the x coordinate of the upper left corner in units of Pixel.
42386
+ * @param value - The value to set.
42387
+ */
42388
+ setXPixel(value: number) : void;
42389
+ /**
42390
+ * Gets or sets the y coordinate of the upper left corner in units of Pixel.
42391
+ */
42392
+ getYPixel() : number;
42393
+ /**
42394
+ * Gets or sets the y coordinate of the upper left corner in units of Pixel.
42395
+ * @param value - The value to set.
42396
+ */
42397
+ setYPixel(value: number) : void;
42398
+ /**
42399
+ * Gets or sets the width of frame in units of Pixel.
42400
+ */
42401
+ getWidthPixel() : number;
42402
+ /**
42403
+ * Gets or sets the width of frame in units of Pixel.
42404
+ * @param value - The value to set.
42405
+ */
42406
+ setWidthPixel(value: number) : void;
42407
+ /**
42408
+ * Gets or sets the height of frame in units of Pixel.
42409
+ */
42410
+ getHeightPixel() : number;
42411
+ /**
42412
+ * Gets or sets the height of frame in units of Pixel.
42413
+ * @param value - The value to set.
42414
+ */
42415
+ setHeightPixel(value: number) : void;
41585
42416
  /**
41586
42417
  * Set position of the frame to automatic
41587
42418
  */
@@ -42665,10 +43496,12 @@ export class Comment {
42665
43496
  setTextVerticalAlignment(value: TextAlignmentType) : void;
42666
43497
  /**
42667
43498
  * Indicates if size of comment is adjusted automatically according to its content.
43499
+ * Note: In some special cases (such as Mac environment), this setting may not take effect. If this setting does not take effect, please replace it with FitToTextSize().
42668
43500
  */
42669
43501
  getAutoSize() : boolean;
42670
43502
  /**
42671
43503
  * Indicates if size of comment is adjusted automatically according to its content.
43504
+ * Note: In some special cases (such as Mac environment), this setting may not take effect. If this setting does not take effect, please replace it with FitToTextSize().
42672
43505
  * @param value - The value to set.
42673
43506
  */
42674
43507
  setAutoSize(value: boolean) : void;
@@ -52525,6 +53358,10 @@ export class Shape {
52525
53358
  * Note:The interface is not fully functional, especially the location information is not correct.It is recommended not to use this interface until the function is complete.
52526
53359
  */
52527
53360
  getActualBox() : number[];
53361
+ /**
53362
+ * Recalculate a text area suitable for displaying all text content.
53363
+ */
53364
+ fitToTextSize() : void;
52528
53365
  /**
52529
53366
  * Checks whether the implementation object is null.
52530
53367
  */
@@ -54428,6 +55265,11 @@ export class StyleFlag {
54428
55265
 
54429
55266
  /**
54430
55267
  * The style modified flags.
55268
+ *
55269
+ * @remarks
55270
+ * Combinations of multiple properties are defined for user's convenience.
55271
+ * When checking whether they are modified for one style, the returned value denotes
55272
+ * whether one or more properties in the combination have been modified.
54431
55273
  */
54432
55274
  export enum StyleModifyFlag {
54433
55275
  /**
@@ -54454,11 +55296,6 @@ export enum StyleModifyFlag {
54454
55296
  * Indicates whether diagonal-up border has been modified for the style.
54455
55297
  */
54456
55298
  DiagonalUpBorder = 8192,
54457
- /**
54458
- * Indicates whether one or more diagonal borders(<see cref="DiagonalDownBorder"/>,
54459
- * <see cref="DiagonalUpBorder"/>) have been modified for the style.
54460
- */
54461
- Diagonal = 12288,
54462
55299
  /**
54463
55300
  * Indicates whether horizontal border has been modified for the style.
54464
55301
  * Only for dynamic style, such as conditional formatting.
@@ -54469,6 +55306,19 @@ export enum StyleModifyFlag {
54469
55306
  * Only for dynamic style, such as conditional formatting.
54470
55307
  */
54471
55308
  VerticalBorder = 64,
55309
+ /**
55310
+ * Indicates the four side borders: <see cref="LeftBorder"/>,
55311
+ * <see cref="RightBorder"/>, <see cref="TopBorder"/> and <see cref="BottomBorder"/>.
55312
+ */
55313
+ SideBorders = 3840,
55314
+ /**
55315
+ * Indicates diagonal borders: <see cref="DiagonalDownBorder"/> and <see cref="DiagonalUpBorder"/>.
55316
+ */
55317
+ Diagonal = 12288,
55318
+ /**
55319
+ * Indicates borders of dynamic style: <see cref="HorizontalBorder"/> and <see cref="VerticalBorder"/>.
55320
+ */
55321
+ DynamicStyleBorders = 96,
54472
55322
  /**
54473
55323
  * Indicates whether one or more borders(<see cref="LeftBorder"/>,
54474
55324
  * <see cref="RightBorder"/>, <see cref="TopBorder"/>, <see cref="BottomBorder"/>,
@@ -54630,9 +55480,13 @@ export enum StyleModifyFlag {
54630
55480
  */
54631
55481
  Font = 31,
54632
55482
  /**
54633
- * Indicates whether one or more properties have been modified for the style.
55483
+ * All properties that can be modified for the style.
54634
55484
  */
54635
55485
  All = 234881023,
55486
+ /**
55487
+ * No property has been specified.
55488
+ */
55489
+ None = 0,
54636
55490
  }
54637
55491
 
54638
55492
  /**
@@ -55715,22 +56569,80 @@ export class Title extends ChartTextFrame {
55715
56569
  setIsVisible(value: boolean) : void;
55716
56570
  /**
55717
56571
  * Gets or sets the x coordinate of the upper left corner in units of 1/4000 of the chart area.
56572
+ *
56573
+ * @remarks
56574
+ * NOTE: This member is now obsolete.
56575
+ * Please use Title.XRatioToChart property, instead.
56576
+ * X = XRatioToChart * 4000;
56577
+ * This property will be removed 12 months later since February 2025.
56578
+ * Aspose apologizes for any inconvenience you may have experienced.
56579
+ * @deprecated
56580
+ * Use Title.XRatioToChart property, instead.
55718
56581
  */
55719
56582
  getX() : number;
55720
56583
  /**
55721
56584
  * Gets or sets the x coordinate of the upper left corner in units of 1/4000 of the chart area.
55722
56585
  * @param value - The value to set.
56586
+ *
56587
+ * @remarks
56588
+ * NOTE: This member is now obsolete.
56589
+ * Please use Title.XRatioToChart property, instead.
56590
+ * X = XRatioToChart * 4000;
56591
+ * This property will be removed 12 months later since February 2025.
56592
+ * Aspose apologizes for any inconvenience you may have experienced.
56593
+ * @deprecated
56594
+ * Use Title.XRatioToChart property, instead.
55723
56595
  */
55724
56596
  setX(value: number) : void;
55725
56597
  /**
55726
56598
  * Gets or sets the y coordinate of the upper left corner in units of 1/4000 of the chart area.
56599
+ *
56600
+ * @remarks
56601
+ * NOTE: This member is now obsolete.
56602
+ * Please use Title.YRatioToChart property, instead.
56603
+ * Y = YRatioToChart * 4000;
56604
+ * This property will be removed 12 months later since February 2025.
56605
+ * Aspose apologizes for any inconvenience you may have experienced.
56606
+ * @deprecated
56607
+ * Use Title.YRatioToChart property, instead.
55727
56608
  */
55728
56609
  getY() : number;
55729
56610
  /**
55730
56611
  * Gets or sets the y coordinate of the upper left corner in units of 1/4000 of the chart area.
55731
56612
  * @param value - The value to set.
56613
+ *
56614
+ * @remarks
56615
+ * NOTE: This member is now obsolete.
56616
+ * Please use Title.YRatioToChart property, instead.
56617
+ * Y = YRatioToChart * 4000;
56618
+ * This property will be removed 12 months later since February 2025.
56619
+ * Aspose apologizes for any inconvenience you may have experienced.
56620
+ * @deprecated
56621
+ * Use Title.YRatioToChart property, instead.
55732
56622
  */
55733
56623
  setY(value: number) : void;
56624
+ /**
56625
+ * Gets or sets the x coordinate of the upper left corner in units of Fraction of the chart area.
56626
+ * X In Pixels = XRatioToChart * Chart.ChartObject.Width;
56627
+ */
56628
+ getXRatioToChart() : number;
56629
+ /**
56630
+ * Gets or sets the x coordinate of the upper left corner in units of Fraction of the chart area.
56631
+ * X In Pixels = XRatioToChart * Chart.ChartObject.Width;
56632
+ * @param value - The value to set.
56633
+ */
56634
+ setXRatioToChart(value: number) : void;
56635
+ /**
56636
+ * Gets or sets the y coordinate of the upper left corner in units of Fraction of the chart area.
56637
+ * Y In Pixels = YRatioToChart * Chart.ChartObject.Width;
56638
+ */
56639
+ getYRatioToChart() : number;
56640
+ /**
56641
+ * Gets or sets the y coordinate of the upper left corner in units of Fraction of the chart area.
56642
+ * Y In Pixels = YRatioToChart * Chart.ChartObject.Width;
56643
+ * @param value - The value to set.
56644
+ */
56645
+ setYRatioToChart(value: number) : void;
55734
56646
  /**
55735
56647
  * Represents overlay centered title on chart without resizing chart.
55736
56648
  */