@mescius/spread-sheets 17.0.0 → 17.0.2

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

@@ -4536,6 +4536,10 @@ declare module GC{
              * When ExcelCompatibleCalcMode disabled, SpreadJS will auto convert text to number for calculation.
              * When ExcelCompatibleCalcMode enabled, treated the text differently when provided as argument directly or in array / reference.
              * For example, A1 is text value "1", SUM(A1, 1) will be 2 if disabled, and 1 if enabled.
+             * @example
+             * ```
+             * GC.Spread.CalcEngine.ExcelCompatibleCalcMode = true;
+             * ```
              */
             var ExcelCompatibleCalcMode: boolean;
             /**
@@ -4653,11 +4657,20 @@ declare module GC{
                 /**
                  * Provides the base class from which the classes that represent expression tree nodes are derived. This is an abstract class.
                  * @class
+                 * @example
+                 * ```
+                 * // the below code will return a Expression
+                 * GC.Spread.Sheets.CalcEngine.formulaToExpression(sheet, "=1");
+                 * ```
                  */
                 constructor(type: GC.Spread.CalcEngine.ExpressionType);
                 /**
                  * Indicates the expression type
                  * @type {GC.Spread.CalcEngine.ExpressionType}
+                 * @example
+                 * ```
+                 * console.log(GC.Spread.Sheets.CalcEngine.formulaToExpression(sheet, "=1").type === GC.Spread.CalcEngine.ExpressionType.number);
+                 * ```
                  */
                 type: GC.Spread.CalcEngine.ExpressionType;
             }
@@ -4732,11 +4745,27 @@ declare module GC{
                      * Represents an abstract base class for defining asynchronous functions.
                      * @class
                      * @param {string} name The name of the function.
-                     * @param {number} minArgs The minimum number of arguments for the function.
-                     * @param {number} maxArgs The maximum number of arguments for the function.
-                     * @param {Object} description The description of the function.
+                     * @param {number} [minArgs] The minimum number of arguments for the function.
+                     * @param {number} [maxArgs] The maximum number of arguments for the function.
+                     * @param {GC.Spread.CalcEngine.Functions.IFunctionDescription} [description] The description of the function.
+                     * @example
+                     * ```
+                     * class WeatherFunction extends GC.Spread.CalcEngine.Functions.AsyncFunction {
+                     *     constructor () {
+                     *         super('WEATHER', 0, 0, {
+                     *             description: "Get Weather",
+                     *             parameters: []
+                     *         });
+                     *     }
+                     *     evaluate (context) {
+                     *         setTimeout(function () { context.setAsyncResult('sunny'); }, 100);
+                     *     }
+                     * }
+                     * spread.addCustomFunction(new WeatherFunction());
+                     * spread.getActiveSheet().setFormula(0, 0, '=WEATHER()');
+                     * ```
                      */
-                    constructor(name: string,  minArgs: number,  maxArgs: number,  description: GC.Spread.CalcEngine.Functions.IFunctionDescription);
+                    constructor(name: string,  minArgs?: number,  maxArgs?: number,  description?: GC.Spread.CalcEngine.Functions.IFunctionDescription);
                     /**
                      * Returns the default value of the evaluated function result before getting the async result.
                      * @returns {Object} The default value of the evaluated function result before getting the async result.
@@ -4765,12 +4794,32 @@ declare module GC{
                     /**
                      * Represents an abstract base class for defining functions.
                      * @class
-                     * @param {string} [name] The name of the function.
+                     * @param {string} name The name of the function.
                      * @param {number} [minArgs] The minimum number of arguments for the function.
                      * @param {number} [maxArgs] The maximum number of arguments for the function.
                      * @param {GC.Spread.CalcEngine.Functions.IFunctionDescription} [functionDescription] The description object of the function.
+                     * @example
+                     * ```
+                     * class FactorialFunction extends GC.Spread.CalcEngine.Functions.Function {
+                     *     constructor () {
+                     *         super('FACTORIAL', 1, 1, {
+                     *             description: "Function to calculate the Fibonacci number.",
+                     *             parameters: [{ name: 'n' }]
+                     *         });
+                     *     }
+                     *     evaluate (n) {
+                     *         var fib = [0, 1];
+                     *         for (var i = 2; i <= n; i++) {
+                     *           fib[i] = fib[i - 1] + fib[i - 2];
+                     *         }
+                     *         return fib[n];
+                     *     }
+                     * }
+                     * spread.addCustomFunction(new FactorialFunction());
+                     * spread.getActiveSheet().setFormula(0, 0, '=FACTORIAL(10)');
+                     * ```
                      */
-                    constructor(name?: string,  minArgs?: number,  maxArgs?: number,  functionDescription?: GC.Spread.CalcEngine.Functions.IFunctionDescription);
+                    constructor(name: string,  minArgs?: number,  maxArgs?: number,  functionDescription?: GC.Spread.CalcEngine.Functions.IFunctionDescription);
                     /**
                      * Represents the maximum number of arguments for the function.
                      * @type {number}
@@ -4834,16 +4883,97 @@ declare module GC{
                      * Finds the branch argument.
                      * @param {Object} test The test.
                      * @returns {number} Indicates the index of the argument that would be treated as the branch condition.
+                     * @example
+                     * ```
+                     * function EqualsFunction() {
+                     *     this.name = 'Equals';
+                     *     this.maxArgs = 3;
+                     *     this.minArgs = 3;
+                     * }
+                     * EqualsFunction.prototype = new GC.Spread.CalcEngine.Functions.Function();
+                     * EqualsFunction.prototype.evaluate = function(logicalTest, valueIfTrue, valueIfFalse) {
+                     *     return logicalTest ? valueIfTrue : valueIfFalse;
+                     * }
+                     * EqualsFunction.prototype.isBranch = function() {
+                     *     return true;
+                     * }
+                     * EqualsFunction.prototype.findTestArgument = function() {
+                     *     return 0;
+                     * }
+                     * EqualsFunction.prototype.findBranchArgument = function(logicalTestResult) {
+                     *     if (logicalTestResult === true) {
+                     *         return 1;
+                     *     }
+                     *     return 2;
+                     * }
+                     * var equalsFunction = new EqualsFunction();
+                     * var spread = GC.Spread.Sheets.findControl("ss") || GC.Spread.Sheets.findControl("sampleDiv");
+                     * spread.addCustomFunction(equalsFunction);
+                     * ```
                      */
                     findBranchArgument(test: any): number;
                     /**
                      * Finds the test argument when this function is branched.
                      * @returns {number} Indicates the index of the argument that would be treated as the test condition.
+                     * @example
+                     * ```
+                     * function EqualsFunction() {
+                     *     this.name = 'Equals';
+                     *     this.maxArgs = 3;
+                     *     this.minArgs = 3;
+                     * }
+                     * EqualsFunction.prototype = new GC.Spread.CalcEngine.Functions.Function();
+                     * EqualsFunction.prototype.evaluate = function(logicalTest, valueIfTrue, valueIfFalse) {
+                     *     return logicalTest ? valueIfTrue : valueIfFalse;
+                     * }
+                     * EqualsFunction.prototype.isBranch = function() {
+                     *     return true;
+                     * }
+                     * EqualsFunction.prototype.findTestArgument = function() {
+                     *     return 0;
+                     * }
+                     * EqualsFunction.prototype.findBranchArgument = function(logicalTestResult) {
+                     *     if (logicalTestResult === true) {
+                     *         return 1;
+                     *     }
+                     *     return 2;
+                     * }
+                     * var equalsFunction = new EqualsFunction();
+                     * var spread = GC.Spread.Sheets.findControl("ss") || GC.Spread.Sheets.findControl("sampleDiv");
+                     * spread.addCustomFunction(equalsFunction);
+                     * ```
                      */
                     findTestArgument(): number;
                     /**
                      * Gets a value that indicates whether this function is branched by arguments as conditional.
                      * @returns {boolean} `true` if this instance is branched; otherwise, `false`.
+                     * @example
+                     * ```
+                     * function EqualsFunction() {
+                     *     this.name = 'Equals';
+                     *     this.maxArgs = 3;
+                     *     this.minArgs = 3;
+                     * }
+                     * EqualsFunction.prototype = new GC.Spread.CalcEngine.Functions.Function();
+                     * EqualsFunction.prototype.evaluate = function(logicalTest, valueIfTrue, valueIfFalse) {
+                     *     return logicalTest ? valueIfTrue : valueIfFalse;
+                     * }
+                     * EqualsFunction.prototype.isBranch = function() {
+                     *     return true;
+                     * }
+                     * EqualsFunction.prototype.findTestArgument = function() {
+                     *     return 0;
+                     * }
+                     * EqualsFunction.prototype.findBranchArgument = function(logicalTestResult) {
+                     *     if (logicalTestResult === true) {
+                     *         return 1;
+                     *     }
+                     *     return 2;
+                     * }
+                     * var equalsFunction = new EqualsFunction();
+                     * var spread = GC.Spread.Sheets.findControl("ss") || GC.Spread.Sheets.findControl("sampleDiv");
+                     * spread.addCustomFunction(equalsFunction);
+                     * ```
                      */
                     isBranch(): boolean;
                     /**
@@ -5123,64 +5253,169 @@ declare module GC{
         module Common{
 
             export interface IDateTimeFormat{
+                /**
+                 * Specifies the day formatter for "ddd".
+                 */
                 abbreviatedDayNames?: string[];
+                /**
+                 * Specifies the month formatter for "MMM".
+                 */
                 abbreviatedMonthGenitiveNames?: string[];
+                /**
+                 * Specifies the month formatter for "MMM".
+                 */
                 abbreviatedMonthNames?: string[];
+                /**
+                 * Indicates the AM designator.
+                 */
                 amDesignator?: string;
+                /**
+                 * Specifies the day formatter for "dddd".
+                 */
                 dayNames?: string[];
+                /**
+                 * Specifies the standard date formatter for "F".
+                 */
                 fullDateTimePattern?: string;
+                /**
+                 * Specifies the standard date formatter for "D".
+                 */
                 longDatePattern?: string;
+                /**
+                 * Specifies the standard date formatter for "T" and "U".
+                 */
                 longTimePattern?: string;
+                /**
+                 * Specifies the standard date formatter for "M" and "m".
+                 */
                 monthDayPattern?: string;
+                /**
+                 * Specifies the formatter for "MMMM".
+                 */
                 monthGenitiveNames?: string[];
+                /**
+                 * Specifies the formatter for "M" or "MM".
+                 */
                 monthNames?: string[];
+                /**
+                 * Indicates the PM designator.
+                 */
                 pmDesignator?: string;
+                /**
+                 * Specifies the standard date formatter for "d".
+                 */
                 shortDatePattern?: string;
+                /**
+                 * Specifies the standard date formatter for "t".
+                 */
                 shortTimePattern?: string;
+                /**
+                 * Specifies the standard date formatter for "y" and "Y".
+                 */
                 yearMonthPattern?: string;
             }
 
 
             export interface ILineBreakingStrategy{
-                (text: string, option: ITextFormatOption) : string[];
+                (text: string, option: GC.Spread.Common.ITextFormatOption) : string[];
             }
 
 
             export interface ILocalNumberFormat{
+                /**
+                 * this property key is number, this property value is format string.
+                 */
                 [K: number]: string;
             }
 
 
             export interface INumberFormat{
+                /**
+                 * Indicates the currency decimal point.
+                 */
                 currencyDecimalSeparator?: string;
+                /**
+                 * Indicates the currency thousand separator.
+                 */
                 currencyGroupSeparator?: string;
+                /**
+                 * Indicates the currency symbol.
+                 */
                 currencySymbol?: string;
+                /**
+                 * Indicates the decimal point.
+                 */
                 numberDecimalSeparator?: string;
+                /**
+                 * Indicates the thousand separator.
+                 */
                 numberGroupSeparator?: string;
+                /**
+                 * Indicates the separator for function arguments in a formula.
+                 */
                 listSeparator?: string;
+                /**
+                 * Indicates the separator for the constants in one row of an array constant in a formula.
+                 */
                 arrayListSeparator?: string;
+                /**
+                 * Indicates the separator for the array rows of an array constant in a formula.
+                 */
                 arrayGroupSeparator?: string;
-                dbNumber?: Object
+                /**
+                 * Specifies the DBNumber characters.
+                 */
+                dbNumber?: Object;
             }
 
 
             export interface IPredefinedFormats{
+                /**
+                 * The formats displayed in currency category.
+                 */
                 Currency?: Array<string>;
+                /**
+                 * The format displayed in accounting category.
+                 */
                 Accounting?: string;
+                /**
+                 * The format displayed in accounting category has no symbol.
+                 */
                 Comma?: string;
+                /**
+                 * The formats in date category.
+                 */
                 Date?: Array<string>;
+                /**
+                 * The formats in time category.
+                 */
                 Time?: Array<string>;
                 Special?: {
                 [K: string]: string;
+                /**
+                 * The formats in special category.
+                 */
                 };
             }
 
 
             export interface ITextFormat{
+                /**
+                 * Specifies the characters can split up two lines. Default is [" ", "-"].
+                 */
                 lineBreakingChar?: string[];
+                /**
+                 * Specifies the characters that are not allowed at the start of a breaking line.
+                 */
                 lineBreakingForbidStart?: string[];
+                /**
+                 * Specifies the characters that are not allowed at the end of a breaking line.
+                 */
                 lineBreakingForbidEnd?: string[];
-                lineBreakingStrategy?: (text: string, option: ITextFormatOption) => string[];
+                /**
+                 * Specifies the function for word split.
+                 */
+                lineBreakingStrategy?: GC.Spread.Common.ILineBreakingStrategy;
             }
 
 
@@ -5200,21 +5435,6 @@ declare module GC{
                 /**
                  * Indicates the date time format fields.
                  * @type {Object}
-                 * @property {string[]} abbreviatedDayNames - Specifies the day formatter for "ddd".
-                 * @property {string[]} abbreviatedMonthGenitiveNames - Specifies the month formatter for "MMM".
-                 * @property {string[]} abbreviatedMonthNames - Specifies the month formatter for "MMM".
-                 * @property {string} amDesignator - Indicates the AM designator.
-                 * @property {string[]} dayNames - Specifies the day formatter for "dddd".
-                 * @property {string} fullDateTimePattern - Specifies the standard date formatter for "F".
-                 * @property {string} longDatePattern - Specifies the standard date formatter for "D".
-                 * @property {string} longTimePattern - Specifies the standard date formatter for "T" and "U".
-                 * @property {string} monthDayPattern - Specifies the standard date formatter for "M" and "m".
-                 * @property {string[]} monthGenitiveNames - Specifies the formatter for "MMMM".
-                 * @property {string[]} monthNames - Specifies the formatter for "M" or "MM".
-                 * @property {string} pmDesignator - Indicates the PM designator.
-                 * @property {string} shortDatePattern - Specifies the standard date formatter for "d".
-                 * @property {string} shortTimePattern - Specifies the standard date formatter for "t".
-                 * @property {string} yearMonthPattern - Specifies the standard date formatter for "y" and "Y".
                  * @example
                  * ```
                  * // This example creates a custom culture.
@@ -5291,9 +5511,8 @@ declare module GC{
                  */
                 id: number;
                 /**
-                 * indicates the local number format built.It's a map whose keys are number and values are formatString.
+                 * indicates the local number format built. It's a map whose keys are number and values are formatString.
                  * @type {Object}
-                 * @property {string} key - this property key is number, this property value is format string.
                  * @example
                  * ```
                  * //this is an example for LocalNumberFormat.
@@ -5308,24 +5527,6 @@ declare module GC{
                 /**
                  * Indicates all the number format fields.
                  * @type {Object}
-                 * @property {string} currencyDecimalSeparator - Indicates the currency decimal point.
-                 * @property {string} currencyGroupSeparator - Indicates the currency thousand separator.
-                 * @property {string} currencySymbol - Indicates the currency symbol.
-                 * @property {string} numberDecimalSeparator - Indicates the decimal point.
-                 * @property {string} numberGroupSeparator - Indicates the thousand separator.
-                 * @property {string} listSeparator - Indicates the separator for function arguments in a formula.
-                 * @property {string} arrayListSeparator - Indicates the separator for the constants in one row of an array constant in a formula.
-                 * @property {string} arrayGroupSeparator - Indicates the separator for the array rows of an array constant in a formula.
-                 * @property {object} dbNumber - Specifies the DBNumber characters.
-                 * The dbNumber object structure as follow:
-                 *  {
-                 *     1: {letters: ['\u5146', '\u5343', '\u767e', '\u5341', '\u4ebf', '\u5343', '\u767e', '\u5341', '\u4e07', '\u5343', '\u767e', '\u5341', ''], // \u5146\u5343\u767e\u5341\u4ebf\u5343\u767e\u5341\u4e07\u5343\u767e\u5341
-                 *         numbers: ['\u25cb', '\u4e00', '\u4e8c', '\u4e09', '\u56db', '\u4e94', '\u516d', '\u4e03', '\u516b', '\u4e5d'] }, // \u25cb\u4e00\u4e8c\u4e09\u56db\u4e94\u516d\u4e03\u516b\u4e5d
-                 *     2: {letters: ['\u5146', '\u4edf', '\u4f70', '\u62fe', '\u4ebf', '\u4edf', '\u4f70', '\u62fe', '\u4e07', '\u4edf', '\u4f70', '\u62fe', ''], // \u5146\u4edf\u4f70\u62fe\u4ebf\u4edf\u4f70\u62fe\u4e07\u4edf\u4f70\u62fe
-                 *         numbers: ['\u96f6', '\u58f9', '\u8d30', '\u53c1', '\u8086', '\u4f0d', '\u9646', '\u67d2', '\u634c', '\u7396']}, // \u96f6\u58f9\u8d30\u53c1\u8086\u4f0d\u9646\u67d2\u634c\u7396
-                 *     3: {letters: null,
-                 *         numbers: ['\uff10', '\uff11', '\uff12', '\uff13', '\uff14', '\uff15', '\uff16', '\uff17', '\uff18', '\uff19']} // \uff10\uff11\uff12\uff13\uff14\uff15\uff16\uff17\uff18\uff19
-                 * };
                  * @example
                  * ```
                  * // This example creates a custom culture.
@@ -5335,6 +5536,14 @@ declare module GC{
                  * myCulture.NumberFormat.numberGroupSeparator = ".";
                  * myCulture.NumberFormat.arrayGroupSeparator = ";";
                  * myCulture.NumberFormat.arrayListSeparator = "\\";
+                 * myCulture.NumberFormat.dbNumber = {
+                 *    1: {letters: ['\u5146', '\u5343', '\u767e', '\u5341', '\u4ebf', '\u5343', '\u767e', '\u5341', '\u4e07', '\u5343', '\u767e', '\u5341', ''], // \u5146\u5343\u767e\u5341\u4ebf\u5343\u767e\u5341\u4e07\u5343\u767e\u5341
+                 *        numbers: ['\u25cb', '\u4e00', '\u4e8c', '\u4e09', '\u56db', '\u4e94', '\u516d', '\u4e03', '\u516b', '\u4e5d'] }, // \u25cb\u4e00\u4e8c\u4e09\u56db\u4e94\u516d\u4e03\u516b\u4e5d
+                 *    2: {letters: ['\u5146', '\u4edf', '\u4f70', '\u62fe', '\u4ebf', '\u4edf', '\u4f70', '\u62fe', '\u4e07', '\u4edf', '\u4f70', '\u62fe', ''], // \u5146\u4edf\u4f70\u62fe\u4ebf\u4edf\u4f70\u62fe\u4e07\u4edf\u4f70\u62fe
+                 *        numbers: ['\u96f6', '\u58f9', '\u8d30', '\u53c1', '\u8086', '\u4f0d', '\u9646', '\u67d2', '\u634c', '\u7396']}, // \u96f6\u58f9\u8d30\u53c1\u8086\u4f0d\u9646\u67d2\u634c\u7396
+                 *    3: {letters: null,
+                 *        numbers: ['\uff10', '\uff11', '\uff12', '\uff13', '\uff14', '\uff15', '\uff16', '\uff17', '\uff18', '\uff19']} // \uff10\uff11\uff12\uff13\uff14\uff15\uff16\uff17\uff18\uff19
+                 * };
                  * myCulture.NumberFormat.listSeparator = ";";
                  * myCulture.DateTimeFormat.amDesignator = "";
                  * myCulture.DateTimeFormat.pmDesignator = "";
@@ -5376,12 +5585,6 @@ declare module GC{
                  * The predefinedFormats is an object that describes part of the number format in format dialog.
                  * When opening the format dialog, designer read predefinedFormats in all CultureInfos to display culture related formats.
                  * @type {Object}
-                 * @property {string} Accounting - The format displayed in accounting category.
-                 * @property {string} Comma - The format displayed in accounting category has no symbol.
-                 * @property {array} Currency - The formats displayed in currency category.
-                 * @property {array} Date - The formats in date category.
-                 * @property {array} Time - The formats in time category.
-                 * @property {object} Special - The formats in special category.
                  * @example
                  * ```
                  * //This is an example for predefinedFormats:
@@ -5436,10 +5639,6 @@ declare module GC{
                 /**
                  * Indicates the text format fields.
                  * @type {Object}
-                 * @property {string[]} lineBreakingChar - Specifies the characters can split up two lines. Default is [" ", "-"].
-                 * @property {string[]} lineBreakingForbidStart - Specifies the characters that are not allowed at the start of a breaking line.
-                 * @property {string[]} lineBreakingForbidEnd - Specifies the characters that are not allowed at the end of a breaking line.
-                 * @property {GC.Spread.Common.ILineBreakingStrategy} lineBreakingStrategy - Specifies the function for word split.
                  * @example
                  * ```
                  * // This example modify culture line breaking strategy.
@@ -5485,6 +5684,18 @@ declare module GC{
                  * @param {string} cultureName The culture name to set.
                  * @param {GC.Spread.Common.CultureInfo} cultureInfo The cultureInfo set to the culture.
                  * @param {object} language The custom language set to the culture. If already set, it will overwrite the old language.
+                 * @example
+                 * ```
+                 * var myCulture = new GC.Spread.Common.CultureInfo();
+                 * myCulture.NumberFormat.currencySymbol = "\u20ac"
+                 * myCulture.NumberFormat.numberDecimalSeparator = ",";
+                 * myCulture.NumberFormat.numberGroupSeparator = ".";
+                 * myCulture.NumberFormat.arrayGroupSeparator = ";";
+                 * myCulture.NumberFormat.arrayListSeparator = "\\";
+                 * myCulture.NumberFormat.listSeparator = ";";
+                 * //add one culture
+                 * GC.Spread.Common.CultureManager.addCultureInfo("de-DE", myCulture);
+                 * ```
                  */
                 static addCultureInfo(cultureName: string,  culture: GC.Spread.Common.CultureInfo,  language?: object): void;
                 /**
@@ -5499,6 +5710,12 @@ declare module GC{
                  * @static
                  * @param {string | number} cultureName Culture name or culture ID
                  * @returns {GC.Spread.Common.CultureInfo} The specified cultureInfo object.
+                 * @example
+                 * ```
+                 * GC.Spread.Common.CultureManager.getCultureInfo(); // return the current culture info.
+                 * GC.Spread.Common.CultureManager.getCultureInfo(1033); // return the culture info of culture id 1033, it's en culture.
+                 * GC.Spread.Common.CultureManager.getCultureInfo('en-us'); // return the culture info of en.
+                 * ```
                  */
                 static getCultureInfo(cultureName: string | number): GC.Spread.Common.CultureInfo;
                 /**
@@ -5511,7 +5728,7 @@ declare module GC{
                 /**
                  * Gets the specified or current working resources.
                  * @static
-                 * @param {string | null} cultureName The culture name to get. If the cultureName is null, will return the current working resources.
+                 * @param {string | null} [cultureName] The culture name to get. If the cultureName is null, will return the current working resources.
                  * @returns {object} The specified or current working resources. Null if not define the language.
                  */
                 static getResources(cultureName?: string): object;
@@ -16821,7 +17038,7 @@ declare module GC{
                 toHtml(headerOptions?: GC.Spread.Sheets.HeaderOptions,  includeStyle?: boolean): string;
                 /**
                  * Gets or sets the data validator for the cell.
-                 * @param {GC.Spread.Sheets.DataValidation.DefaultDataValidator} value The cell data validator.
+                 * @param {GC.Spread.Sheets.DataValidation.DefaultDataValidator} [value] The cell data validator.
                  * @returns {GC.Spread.Sheets.DataValidation.DefaultDataValidator|GC.Spread.Sheets.CellRange} If no value is set, returns the cell data validator; otherwise, returns the cell.
                  * @example
                  * ```
@@ -19110,6 +19327,7 @@ declare module GC{
                  * @param eventParam *string* `sheetName` The sheet's name.
                  * @param eventParam *number* `row` The cell's row index.
                  * @param eventParam *number* `col` The cell's column index.
+                 * @param eventParam *Object* `editingValue` The cell's editing value.
                  * @param eventParam *{@link GC.Spread.Sheets.DataValidation.DefaultDataValidator}* `validator` The data validator that caused the error.
                  * @param eventParam *{@link GC.Spread.Sheets.DataValidation.DataValidationResult}* `validationResult` The policy that the user can set to determine how to process the error.
                  * @example
@@ -20639,25 +20857,49 @@ declare module GC{
                 constructor(name: string,  colorScheme: ColorScheme,  headerFont: string,  bodyFont: string);
                 /**
                  * Gets or sets the body font of the theme.
-                 * @param {string} value The body font.
+                 * @param {string} [value] The body font.
                  * @returns {string|GC.Spread.Sheets.Theme} If no value is set, returns the body font; otherwise, returns the theme.
+                 * @example
+                 * ```
+                 * var custom = new GC.Spread.Sheets.Theme("Custom");
+                 * custom.bodyFont('cursive');
+                 * sheet.currentTheme(custom);
+                 * sheet.setValue(0, 0, 'hello world!'); // The font of the cell will be 'cursive'.
+                 * ```
                  */
                 bodyFont(value?: string): any;
                 /**
                  * Gets or sets the base colors of the theme.
-                 * @param {GC.Spread.Sheets.ColorScheme} value The base colors of the theme.
+                 * @param {GC.Spread.Sheets.ColorScheme} [value] The base colors of the theme.
                  * @returns {GC.Spread.Sheets.ColorScheme|GC.Spread.Sheets.Theme} If no value is set, returns the base colors of the theme; otherwise, returns the theme.
+                 * @example
+                 * ```
+                 * var custom = new GC.Spread.Sheets.Theme("Custom");
+                 * custom.colors().accent1("red");
+                 * custom.colors().accent6("green");
+                 * sheet.currentTheme(custom);
+                 * sheet.getCell(0, 0).backColor("accent 1"); // The background color of the cell will be red.
+                 * sheet.getCell(0, 1).backColor("accent 6"); // The background color of the cell will be green.
+                 * ```
                  */
                 colors(value?: GC.Spread.Sheets.ColorScheme): any;
                 /**
                  * Gets or sets the heading font of the theme.
-                 * @param {string} value The heading font.
+                 * @param {string} [value] The heading font.
                  * @returns {string|GC.Spread.Sheets.Theme} If no value is set, returns the heading font; otherwise, returns the theme.
+                 * @example
+                 * ```
+                 * var custom = new GC.Spread.Sheets.Theme("Custom");
+                 * custom.headerFont('cursive');
+                 * sheet.currentTheme(custom);
+                 * sheet.getCell(0, 0).themeFont('Headings');
+                 * sheet.setValue(0, 0, 'hello world!'); // The font of the cell will be 'cursive'.
+                 * ```
                  */
                 headerFont(value?: string): any;
                 /**
                  * Gets or sets the name of the theme.
-                 * @param {string} value The theme name.
+                 * @param {string} [value] The theme name.
                  * @returns {string|GC.Spread.Sheets.Theme} If no value is set, returns the theme name; otherwise, returns the theme.
                  */
                 name(value?: string): any;
@@ -24122,7 +24364,7 @@ declare module GC{
                 resumePaint(): void;
                 /**
                  * Gets or sets the row filter for the sheet.
-                 * @param {GC.Spread.Sheets.Filter.RowFilterBase} value The row filter for the sheet.
+                 * @param {GC.Spread.Sheets.Filter.RowFilterBase} [value] The row filter for the sheet.
                  * @returns {GC.Spread.Sheets.Filter.RowFilterBase|GC.Spread.Sheets.Worksheet} invoking the method without parameter, will return the filter instance, otherwise, return the worksheet instance.
                  * @example
                  * ```
@@ -24130,7 +24372,7 @@ declare module GC{
                  * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(1,1,10,3)));
                  * ```
                  */
-                rowFilter(value?: GC.Spread.Sheets.Filter.RowFilterBase): GC.Spread.Sheets.Filter.RowFilterBase;
+                rowFilter(value?: GC.Spread.Sheets.Filter.RowFilterBase): any;
                 /**
                  * Scrolls the sheet by specified pixels.
                  * When vPixels is positive, worksheet will scroll down; when vPixels is negative, worksheet will scroll up; when vPixels is 0, worksheet won't scroll in vertical direction.
@@ -24427,7 +24669,7 @@ declare module GC{
                  * @param {number} row The row index.
                  * @param {number} col The column index.
                  * @param {GC.Spread.Sheets.DataValidation.DefaultDataValidator} value The data validator.
-                 * @param {GC.Spread.Sheets.SheetArea} sheetArea The sheet area. If this parameter is not provided, it defaults to `viewport`.
+                 * @param {GC.Spread.Sheets.SheetArea} [sheetArea] The sheet area. If this parameter is not provided, it defaults to `viewport`.
                  * @example
                  * ```
                  * spread.options.highlightInvalidData = true;
@@ -24447,7 +24689,7 @@ declare module GC{
                  * @param {number} rowCount The row count.
                  * @param {number} colCount The column count.
                  * @param {GC.Spread.Sheets.DataValidation.DefaultDataValidator} value The data validator.
-                 * @param {GC.Spread.Sheets.SheetArea} sheetArea The sheet area. If this parameter is not provided, it defaults to `viewport`.
+                 * @param {GC.Spread.Sheets.SheetArea} [sheetArea] The sheet area. If this parameter is not provided, it defaults to `viewport`.
                  * @example
                  * ```
                  * spread.options.highlightInvalidData = true;
@@ -24496,7 +24738,7 @@ declare module GC{
                  * Sets a formula in a specified cell in the specified sheet area.
                  * @param {number} row The row index.
                  * @param {number} col The column index.
-                 * @param {string} value The formula to place in the specified cell.
+                 * @param {string|null} value The formula to place in the specified cell.
                  * @param {GC.Spread.Sheets.SheetArea} [sheetArea] The sheet area. If you do not provide this parameter, it defaults to `viewport`.
                  * @example
                  * ```
@@ -24505,7 +24747,7 @@ declare module GC{
                  * activeSheet.setFormula(1,1,"C1+D1",GC.Spread.Sheets.SheetArea.viewport);
                  * ```
                  */
-                setFormula(row: number,  col: number,  value: string,  sheetArea?: GC.Spread.Sheets.SheetArea): void;
+                setFormula(row: number,  col: number,  value: string | null,  sheetArea?: GC.Spread.Sheets.SheetArea): void;
                 /**
                  * Sets the hyperlink data for the specified cell in the specified sheet area.
                  * @param {number} row The row index.
@@ -28534,7 +28776,7 @@ declare module GC{
                      */
                     name(value?: string): any;
                     /**
-                     * Refresh the content in floatingObject.The user should override this method to make their content synchronize with the floatingObject.
+                     * Refreshes the chart, in most cases does not need to call this method.
                      */
                     refreshContent(): void;
                     /**
@@ -30749,14 +30991,21 @@ declare module GC{
                 export enum CommentState{
                     /**
                      * Specifies that the comment is in an active state.
+                     * In the active state, the comment is currently being selected.
+                     * User can move the comment's position or resize the comment.
                      */
                     active= 1,
                     /**
-                     *Specifies that the comment is in an editing state.
+                     * Specifies that the comment is in an editing state.
+                     * The edit state of an comment signifies that the comment is actively being modified or updated.
+                     * This state occurs when a user is making changes to the content of the comment.
                      */
                     edit= 2,
                     /**
                      * Specifies that the comment is in a normal state.
+                     * In the normal state, the comment is currently not being selected.
+                     * User cannot interact with a comment in normal state.
+                     * Clicking on the comment will change the state into active or edit.
                      */
                     normal= 3
                 }
@@ -31360,6 +31609,14 @@ declare module GC{
                      * @param {number} right The right padding.
                      * @param {number} bottom The bottom padding.
                      * @param {number} left The left padding.
+                     * @example
+                     * ```
+                     * var comment = activeSheet.comments.add(2, 2, 'this is a comment');
+                     * comment.displayMode(GC.Spread.Sheets.Comments.DisplayMode.alwaysShown)
+                     * console.log(comment.padding()); // undefined
+                     * comment.padding(new GC.Spread.Sheets.Comments.Padding(10, 20, 30, 40));
+                     * console.log(comment.padding()); // Padding {top: 10, right: 20, bottom: 30, left: 40}
+                     * ```
                      */
                     constructor(top?: number,  right?: number,  bottom?: number,  left?: number);
                 }
@@ -35124,7 +35381,7 @@ declare module GC{
                  * @static
                  * @param {GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators} typeOperator The compare operator type. The possible values for this attribute are defined by the GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.
                  * @param {object} v1 The first object.
-                 * @param {object} v2 The second object.
+                 * @param {object} [v2] The second object.
                  * @returns {GC.Spread.Sheets.DataValidation.DefaultDataValidator} The validator.
                  * @example
                  * ```
@@ -35197,8 +35454,8 @@ declare module GC{
                  * @static
                  * @param {GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators} typeOperator The compare operator type. The possible values for this attribute are defined by the GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.
                  * @param {object} v1 The first object.
-                 * @param {object} v2 The second object.
-                 * @param {boolean} isIntegerValue Set to `true` if the validator is set to a number.
+                 * @param {object} [v2] The second object.
+                 * @param {boolean} [isIntegerValue] Set to `true` if the validator is set to a number.
                  * @returns {GC.Spread.Sheets.DataValidation.DefaultDataValidator} The validator.
                  * @example
                  * ```
@@ -35216,7 +35473,7 @@ declare module GC{
                  * @static
                  * @param {GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators} typeOperator The compare operator type. The possible values for this attribute are defined by the GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.
                  * @param {object} v1 The first object.
-                 * @param {object} v2 The second object.
+                 * @param {object} [v2] The second object.
                  * @returns {GC.Spread.Sheets.DataValidation.DefaultDataValidator} The validator.
                  * @example
                  * ```
@@ -35234,7 +35491,7 @@ declare module GC{
                  * @static
                  * @param {GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators} typeOperator The compare operator type. The possible values for this attribute are defined by the GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.
                  * @param {object} v1 The first object.
-                 * @param {object} v2 The second object.
+                 * @param {object} [v2] The second object.
                  * @returns {GC.Spread.Sheets.DataValidation.DefaultDataValidator} The validator.
                  * @example
                  * ```
@@ -35247,6 +35504,26 @@ declare module GC{
                  * ```
                  */
                 function createTimeValidator(typeOperator: GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators,  v1: Object,  v2?: Object): GC.Spread.Sheets.DataValidation.DefaultDataValidator;
+
+                export interface IHighLightStyle{
+                    /**
+                     * Indicates the data validation highlightType.
+                     */
+                    type?: GC.Spread.Sheets.DataValidation.HighlightType;
+                    /**
+                     * Indicates the data validation highlight color.
+                     */
+                    color?: string;
+                    /**
+                     * Indicates the data validation highlight position.
+                     */
+                    position?: GC.Spread.Sheets.DataValidation.HighlightPosition;
+                    /**
+                     * Indicates the data validation highlight image url or data.
+                     */
+                    image?: string;
+                }
+
                 /**
                  * Indicates the data validator criteria type.
                  * @enum {number}
@@ -35408,31 +35685,31 @@ declare module GC{
                     constructor(condition?: GC.Spread.Sheets.ConditionalFormatting.Condition);
                     /**
                      * Gets or sets the comparison operator.
-                     * @param {GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators} value The comparison operator.
+                     * @param {GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators} [value] The comparison operator.
                      * @returns {GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the comparison operator; otherwise, returns the data validator.
                      */
                     comparisonOperator(value?: GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators): any;
                     /**
                      * Gets or sets the condition to validate.
-                     * @param {GC.Spread.Sheets.ConditionalFormatting.Condition} value The condition to validate.
+                     * @param {GC.Spread.Sheets.ConditionalFormatting.Condition} [value] The condition to validate.
                      * @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.
                      */
                     condition(value?: GC.Spread.Sheets.ConditionalFormatting.Condition): any;
                     /**
                      * Gets or sets the error message.
-                     * @param {string} value The error message.
+                     * @param {string} [value] The error message.
                      * @returns {string | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the error message; otherwise, returns the data validator.
                      */
                     errorMessage(value?: string): any;
                     /**
                      * Gets or sets the error style to display.
-                     * @param {GC.Spread.Sheets.DataValidation.ErrorStyle} value The error style to display.
+                     * @param {GC.Spread.Sheets.DataValidation.ErrorStyle} [value] The error style to display.
                      * @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.
                      */
                     errorStyle(value?: GC.Spread.Sheets.DataValidation.ErrorStyle): any;
                     /**
                      * Gets or sets the error title.
-                     * @param {string} value The error title.
+                     * @param {string} [value] The error title.
                      * @returns {string | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the error title; otherwise, returns the data validator.
                      */
                     errorTitle(value?: string): any;
@@ -35446,11 +35723,8 @@ declare module GC{
                     getValidList(evaluator: Object,  baseRow: number,  baseColumn: number): any[];
                     /**
                      * Get or Sets the invalid data cell highlight style.
-                     * @param {GC.Spread.Sheets.DataValidation.HighlightType} [style.type] - typeIndicates the data validation highlightType.
-                     * @param {string} [style.color] - Indicates the data validation highlight color.
-                     * @param {GC.Spread.Sheets.DataValidation.HighlightPosition} [style.position] - Indicates the data validation highlight position.
-                     * @param {string} [style.image] - Indicates the data validation highlight image url or data.
-                     * @returns {Object | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the hignlight style object; otherwise, returns the data validator.
+                     * @param {GC.Spread.Sheets.DataValidation.IHighLightStyle} [style] - The style of invalid data cell.
+                     * @returns {GC.Spread.Sheets.DataValidation.IHighLightStyle | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the hignlight style object; otherwise, returns the data validator.
                      * @example
                      * ```
                      * //This example uses the highlightStyle method.
@@ -35465,10 +35739,10 @@ declare module GC{
                      * spread.options.highlightInvalidData = true;
                      * ```
                      */
-                    highlightStyle(style?: Object): Object;
+                    highlightStyle(style?: GC.Spread.Sheets.DataValidation.IHighLightStyle): any;
                     /**
                      * Gets or sets whether to ignore an empty value.
-                     * @param {boolean} value Indicates whether to ignore the empty value.
+                     * @param {boolean} [value] Indicates whether to ignore the empty value.
                      * @returns {boolean | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns whether to ignore the empty value; otherwise, returns the data validator.
                      * @example
                      * ```
@@ -35490,7 +35764,7 @@ declare module GC{
                     ignoreBlank(value?: boolean): any;
                     /**
                      * Gets or sets whether to display a drop-down button.
-                     * @param {boolean} value Indicates whether to display a drop-down button.
+                     * @param {boolean} [value] Indicates whether to display a drop-down button.
                      * @returns {boolean | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns whether to display a drop-down button; otherwise, returns the data validator.
                      * @example
                      * ```
@@ -35509,7 +35783,7 @@ declare module GC{
                     inCellDropdown(value?: boolean): any;
                     /**
                      * Gets or sets the input message.
-                     * @param {string} value The input message.
+                     * @param {string} [value] The input message.
                      * @returns {string | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the input message; otherwise, returns the data validator.
                      * @example
                      * ```
@@ -35525,7 +35799,7 @@ declare module GC{
                     inputMessage(value?: string): any;
                     /**
                      * Gets or sets the input title.
-                     * @param {string} value The input title.
+                     * @param {string} [value] The input title.
                      * @returns {string | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns the input title; otherwise, returns the data validator.
                      * @example
                      * ```
@@ -35546,11 +35820,29 @@ declare module GC{
                      * @param {number} baseColumn The base column.
                      * @param {object} actual The current value.
                      * @returns {boolean} `true` if the value is valid; otherwise, `false`.
+                     * @example
+                     * ```
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ 3.4 ],
+                     *         [ 102.8 ]
+                     *     ]);
+                     * var expression1 = 1.1;
+                     * var expression2 = 101.2;
+                     * var dv = GC.Spread.Sheets.DataValidation.createNumberValidator(GC.Spread.Sheets.ConditionalFormatting.ComparisonOperators.between, expression1, expression2, false);
+                     * sheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(dv);
+                     * dv = sheet.getCell(0, 0, GC.Spread.Sheets.SheetArea.viewport).validator(); // Limitation of SDM, the dv is copied when set to style.
+                     * console.log(dv.isValid(sheet, 0, 0, 3)); // true
+                     * console.log(dv.isValid(sheet, 0, 0, 1)); // false
+                     * console.log(dv.isValid(sheet, 0, 0, 101)); // true
+                     * console.log(dv.isValid(sheet, 0, 0, 0)); // false
+                     * console.log(dv.isValid(sheet, 0, 0, 120.0)); // false
+                     * ```
                      */
                     isValid(evaluator: Object,  baseRow: number,  baseColumn: number,  actual: Object): boolean;
                     /**
                      * Gets or sets whether to compare whole day or precise date time.
-                     * @param {boolean} value Indicates compare whole day or precise date time.
+                     * @param {boolean} [value] Indicates compare whole day or precise date time.
                      * @returns {boolean | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns compare whole day or precise date time; otherwise, returns the data validator.
                      * @example
                      * ```
@@ -35592,7 +35884,7 @@ declare module GC{
                     reset(): void;
                     /**
                      * Gets or sets whether to display an error message.
-                     * @param {boolean} value Indicates whether to display an error message.
+                     * @param {boolean} [value] Indicates whether to display an error message.
                      * @returns {boolean | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns whether to display an error message; otherwise, returns the data validator.
                      * @example
                      * ```
@@ -35620,7 +35912,7 @@ declare module GC{
                     showErrorMessage(value?: boolean): any;
                     /**
                      * Gets or sets whether to display the input title and input message.
-                     * @param {boolean} value Indicates whether to display the input title and input message.
+                     * @param {boolean} [value] Indicates whether to display the input title and input message.
                      * @returns {boolean | GC.Spread.Sheets.DataValidation.DefaultDataValidator} If no value is set, returns whether to display the input title and input message; otherwise, returns the data validator.
                      * @example
                      * ```
@@ -35636,14 +35928,14 @@ declare module GC{
                     showInputMessage(value?: boolean): any;
                     /**
                      * Gets or sets the criteria type of this data validator.
-                     * @param {GC.Spread.Sheets.DataValidation.CriteriaType} value The criteria type of this data validator.
+                     * @param {GC.Spread.Sheets.DataValidation.CriteriaType} [value] The criteria type of this data validator.
                      * @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.
                      */
                     type(value?: GC.Spread.Sheets.DataValidation.CriteriaType): any;
                     /**
                      * Gets the first value of the data validation.
-                     * @param {number} baseRow The base row.
-                     * @param {number} baseColumn The base column.
+                     * @param {number} [baseRow] The base row.
+                     * @param {number} [baseColumn] The base column.
                      * @returns {object} The first value.
                      * @example
                      * ```
@@ -35663,11 +35955,11 @@ declare module GC{
                      * alert(validator.value1());
                      * ```
                      */
-                    value1(baseRow ?: number,  baseColumn ?: number): any;
+                    value1(baseRow?: number,  baseColumn?: number): any;
                     /**
                      * Gets the second value of the data validation.
-                     * @param {number} baseRow The base row.
-                     * @param {number} baseColumn The base column.
+                     * @param {number} [baseRow] The base row.
+                     * @param {number} [baseColumn] The base column.
                      * @returns {object} The second value.
                      * @example
                      * ```
@@ -35687,7 +35979,7 @@ declare module GC{
                      * alert(validator.value2());
                      * ```
                      */
-                    value2(baseRow ?: number,  baseColumn ?: number): any;
+                    value2(baseRow?: number,  baseColumn?: number): any;
                 }
             }
 
@@ -35893,21 +36185,36 @@ declare module GC{
             module Filter{
 
                 export interface IFilterDialogVisibleInfo{
-                    sortByValue? : boolean,
-                    sortByColor? : boolean,
-                    filterByColor? : boolean,
-                    filterByValue? : boolean,
-                    listFilterArea? : boolean
+                    /**
+                     * Whether to show the sort by value area in filter dialog.
+                     */
+                    sortByValue? : boolean;
+                    /**
+                     * Whether to show the sort by color area in filter dialog.
+                     */
+                    sortByColor? : boolean;
+                    /**
+                     * Whether to show the filter by color area in filter dialog.
+                     */
+                    filterByColor? : boolean;
+                    /**
+                     * Whether to show the filter by value area in filter dialog.
+                     */
+                    filterByValue? : boolean;
+                    /**
+                     * Whether to show the list filter in filter dialog.
+                     */
+                    listFilterArea? : boolean;
                 }
 
 
                 export interface IFilteredArgs{
-                    action: FilterActionType;
-                    sheet: Sheets.Worksheet;
-                    range: Sheets.Range;
+                    action: GC.Spread.Sheets.Filter.FilterActionType;
+                    sheet: GC.Spread.Sheets.Worksheet;
+                    range: GC.Spread.Sheets.Range;
                     filteredRows: number[];
                     filteredOutRows: number[];
-                    columns: number;
+                    columns: number[];
                 }
 
                 /**
@@ -35929,7 +36236,7 @@ declare module GC{
                      * Represents a default row filter.
                      * @class GC.Spread.Sheets.Filter.HideRowFilter
                      * @extends GC.Spread.Sheets.Filter.RowFilterBase
-                     * @param {GC.Spread.Sheets.Range} range The filter range.
+                     * @param {GC.Spread.Sheets.Range} [range] The filter range.
                      * @example
                      * ```
                      * //The following example creates a new filter.
@@ -35940,25 +36247,20 @@ declare module GC{
                     constructor(range?: GC.Spread.Sheets.Range);
                     /**
                      * Gets or sets the visible info for the row filter.
-                     * @param {Object} visibleInfo The visible info for row filter.
-                     * @param {boolean} [visibleInfo.sortByValue] Whether to show the sort by value area in filter dialog.
-                     * @param {boolean} [visibleInfo.sortByColor] Whether to show the sort by color area in filter dialog.
-                     * @param {boolean} [visibleInfo.filterByColor] Whether to show the filter by color area in filter dialog.
-                     * @param {boolean} [visibleInfo.filterByValue] Whether to show the filter by value area in filter dialog.
-                     * @param {boolean} [visibleInfo.listFilterArea] Whether to show the list filter in filter dialog.
-                     * @returns {Object | GC.Spread.Sheets.Filter.HideRowFilter} If no value is set filter dialog visible info; otherwise, returns the HideRowFilter.
+                     * @param {GC.Spread.Sheets.Filter.IFilterDialogVisibleInfo} [visibleInfo] The visible info for row filter.
+                     * @returns {GC.Spread.Sheets.Filter.IFilterDialogVisibleInfo | GC.Spread.Sheets.Filter.HideRowFilter} If no value is set filter dialog visible info; otherwise, returns the HideRowFilter.
                      * @example
                      * ```
                      * //This example creates a row filter.
-                     *  sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(1,1,10,3)));
+                     *  sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(1, 1, 10, 3)));
                      *  var filter = sheet.rowFilter();
                      *  filter.filterDialogVisibleInfo({
-                     *           sortByValue : false,
-                     *           sortByColor : true,
-                     *           filterByColor : true,
-                     *           filterByValue : true,
-                     *           listFilterArea : false
-                     *       })
+                     *      sortByValue : false,
+                     *      sortByColor : true,
+                     *      filterByColor : true,
+                     *      filterByValue : true,
+                     *      listFilterArea : false
+                     *  });
                      * ```
                      */
                     filterDialogVisibleInfo(visibleInfo?: GC.Spread.Sheets.Filter.IFilterDialogVisibleInfo): any;
@@ -35970,7 +36272,7 @@ declare module GC{
                      * @class GC.Spread.Sheets.Filter.RowFilterBase
                      * @param {GC.Spread.Sheets.Range} range The filter range.
                      */
-                    constructor(range?: GC.Spread.Sheets.Range);
+                    constructor(range: GC.Spread.Sheets.Range);
                     /**
                      * Represents the extendedRange for the row filter.
                      * @type {GC.Spread.Sheets.Range}
@@ -35989,12 +36291,42 @@ declare module GC{
                     /**
                      * Adds a specified filter to the row filter.
                      * @param {number} col The column index.
-                     * @param {GC.Spread.Sheets.ConditionalFormatting.Condition} condition The condition to filter.
+                     * @param {GC.Spread.Sheets.ConditionalFormatting.Condition|GC.Spread.Sheets.ConditionalFormatting.Condition[]} condition The condition to filter.
+                     * @example
+                     * ```
+                     * sheet.setRowCount(3);
+                     * sheet.setColumnCount(1);
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ 1 ],
+                     *         [ 2 ],
+                     *         [ 3 ]
+                     *     ]);
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(-1, -1, -1, -1)));
+                     * var condition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.textCondition, {compareType: GC.Spread.Sheets.ConditionalFormatting.TextCompareType.equalsTo,expected: '3'});
+                     * sheet.rowFilter().addFilterItem(0, condition);
+                     * sheet.rowFilter().filter(0);
+                     * ```
                      */
-                    addFilterItem(col: number,  condition: GC.Spread.Sheets.ConditionalFormatting.Condition): void;
+                    addFilterItem(col: number,  condition: GC.Spread.Sheets.ConditionalFormatting.Condition | GC.Spread.Sheets.ConditionalFormatting.Condition[]): void;
                     /**
                      * Filters the specified column.
                      * @param {number} col The index of the column to be filtered; if it is omitted, all the columns in the range will be filtered.
+                     * @example
+                     * ```
+                     * sheet.setRowCount(2);
+                     * sheet.setColumnCount(1);
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ "a" ],
+                     *         [ "b" ]
+                     *     ]);
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(-1, -1, -1, -1)));
+                     * var condition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.textCondition, {compareType: GC.Spread.Sheets.ConditionalFormatting.TextCompareType.equalsTo,expected: 'a'});
+                     * var rowFilter = sheet.rowFilter();
+                     * rowFilter.addFilterItem(0, condition);
+                     * rowFilter.filter(0);
+                     * ```
                      */
                     filter(col?: number): void;
                     /**
@@ -36006,6 +36338,20 @@ declare module GC{
                      *      One parameter col `false` if the specified column filter button is invisible; otherwise, `true`.
                      *      One parameter value <c>GC.Spread.Sheets.Filter.RowFilterBase</c> sets all filter buttons to be visible(true)/invisible(false).
                      *      Two parameters col,value <c>GC.Spread.Sheets.Filter.RowFilterBase</c> sets the specified column filter button to be visible(true)/invisible(false).
+                     * @example
+                     * ```
+                     * sheet.setArray(2, 2,
+                     *     [
+                     *         [ 1, 4 ],
+                     *         [ 2, 5 ],
+                     *         [ 3, 6 ]
+                     *     ] );
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(2, 2, 3, 2)));
+                     * console.log(sheet.rowFilter().filterButtonVisible()); // true
+                     * sheet.rowFilter().filterButtonVisible(2, false);
+                     * console.log(sheet.rowFilter().filterButtonVisible(2)); // false
+                     * console.log(sheet.rowFilter().filterButtonVisible(3)); // true
+                     * ```
                      */
                     filterButtonVisible(col?: number | boolean,  value?: boolean): any;
                     /**
@@ -36016,23 +36362,74 @@ declare module GC{
                     /**
                      * Gets all the filtered conditions.
                      * @returns {GC.Spread.Sheets.ConditionalFormatting.Condition[]} Returns a collection that contains all the filtered conditions.
+                     * @example
+                     * ```
+                     * sheet.setRowCount(3);
+                     * sheet.setColumnCount(2);
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ 1, 2 ],
+                     *         [ 3, 4 ],
+                     *         [ 5, 6 ]
+                     *     ]);
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(-1, -1, -1, -1)));
+                     * var condition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.numberCondition, { compareType: GC.Spread.Sheets.ConditionalFormatting.GeneralComparisonOperators.greaterThan, expected: 1 });
+                     * var condition1 = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.numberCondition, { compareType: GC.Spread.Sheets.ConditionalFormatting.GeneralComparisonOperators.greaterThan, expected: 4 });
+                     * sheet.rowFilter().addFilterItem(0, condition);
+                     * sheet.rowFilter().addFilterItem(1, condition1);
+                     * console.log(sheet.rowFilter().getFilteredItems().length); // 0
+                     * sheet.rowFilter().filter();
+                     * console.log(sheet.rowFilter().getFilteredItems().length); // 2
+                     * sheet.rowFilter().removeFilterItems(0);
+                     * console.log(sheet.rowFilter().getFilteredItems().length); // 1
+                     * sheet.rowFilter().removeFilterItems(1);
+                     * console.log(sheet.rowFilter().getFilteredItems().length); // 0
+                     * ```
                      */
                     getFilteredItems(): GC.Spread.Sheets.ConditionalFormatting.Condition[];
                     /**
                      * Gets the filters for the specified column.
                      * @param {number} col The column index.
                      * @returns {GC.Spread.Sheets.ConditionalFormatting.Condition[]} Returns a collection that contains conditions that belong to a specified column.
+                     * @example
+                     * ```
+                     * sheet.getCell(0, 0).value("a");
+                     * sheet.getCell(0, 1).value("b");
+                     * sheet.getCell(1, 0).value("ac");
+                     * sheet.getCell(1, 1).value("bd");
+                     * sheet.rowFilter( new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range( -1, -1, -1, -1)));
+                     * var condition1 =  new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.textCondition, { compareType: GC.Spread.Sheets.ConditionalFormatting.TextCompareType.equalsTo,expected: 'a' });
+                     * var condition2 = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.textCondition, { compareType: GC.Spread.Sheets.ConditionalFormatting.TextCompareType.equalsTo,beginsWith: '' });
+                     * sheet.rowFilter().addFilterItem(0, condition1);
+                     * sheet.rowFilter().addFilterItem(1, condition2);
+                     * console.log(sheet.rowFilter().getFilterItems(0)); // result is array, length is 1, and the item equals to condition1.
+                     * ```
                      */
                     getFilterItems(col: number): GC.Spread.Sheets.ConditionalFormatting.Condition[];
                     /**
                      * Gets the current sort state.
                      * @param {number} col The column index.
                      * @returns {GC.Spread.Sheets.SortState} The sort state of the current filter.
+                     * @example
+                     * ```
+                     * sheet.setArray(0, 0, [
+                     *     [ 4 ],
+                     *     [ 3 ],
+                     *     [ 2 ],
+                     *     [ 1 ],
+                     *     [ 0 ]
+                     * ]);
+                     * sheet.rowFilter( new GC.Spread.Sheets.Filter.HideRowFilter( new GC.Spread.Sheets.Range( 0, 0, 5, 1 ) ) );
+                     * sheet.rowFilter().addFilterItem( 0, new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.numberCondition, { compareType: GC.Spread.Sheets.ConditionalFormatting.GeneralComparisonOperators.greaterThan, expected: 2 }));
+                     * sheet.rowFilter().filter(0);
+                     * sheet.rowFilter().sortColumn(0, false);
+                     * console.log(sheet.rowFilter().getSortState(0)); // 2
+                     * ```
                      */
                     getSortState(col: number): GC.Spread.Sheets.SortState;
                     /**
                      * Gets a value that indicates whether any row or specified column is filtered.
-                     * @param {number} col The column index.
+                     * @param {number} [col] The column index.
                      * @returns {boolean}  No parameter `true` if some rows are filtered; otherwise, `false`.
                      *                     One parameter col `true` if the specified column is filtered; otherwise, `false`.
                      * @example
@@ -36058,7 +36455,7 @@ declare module GC{
                      *     }
                      * });
                      * //Add button control to page
-                     * &lt;input type="button" id="button1" value="button1"/&gt;
+                     * <input type="button" id="button1" value="button1"/>
                      * ```
                      */
                     isFiltered(col?: number): boolean;
@@ -36066,31 +36463,130 @@ declare module GC{
                      * Determines whether the specified row is filtered out.
                      * @param {number} row The row index.
                      * @returns {boolean} `true` if the row is filtered out; otherwise, `false`.
+                     * @example
+                     * ```
+                     * sheet.setRowCount(2);
+                     * sheet.setColumnCount(1);
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ 1 ],
+                     *         [ 2 ]
+                     *     ] );
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(-1, -1, -1, -1)));
+                     * var condition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.textCondition, {compareType: GC.Spread.Sheets.ConditionalFormatting.TextCompareType.equalsTo,expected: '2'});
+                     * sheet.rowFilter().addFilterItem(0, condition);
+                     * sheet.rowFilter().filter(0);
+                     * sheet.addRows(1, 1);
+                     * console.log(sheet.rowFilter().isFiltered()); // true
+                     * console.log(sheet.rowFilter().isRowFilteredOut(0)); // true
+                     * console.log(sheet.rowFilter().isRowFilteredOut(1)); // false
+                     * ```
                      */
                     isRowFilteredOut(row: number): boolean;
                     /**
                      * Performs the action when some columns have just been filtered or unfiltered.
-                     * @param {object} args An object that contains the <i>action</i>, <i>sheet</i>, <i>range</i>, <i>filteredRows</i>, and <i>filteredOutRows</i>. See the Remarks for additional information.
+                     * @param {GC.Spread.Sheets.Filter.IFilteredArgs} args An object that contains the <i>action</i>, <i>sheet</i>, <i>range</i>, <i>filteredRows</i>, <i>filteredOutRows</i>, and <i>columns</i>.
+                     * @example
+                     * ```
+                     * sheet.setRowCount(3);
+                     * sheet.setColumnCount(2);
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ 1, 2 ],
+                     *         [ 3, 4 ],
+                     *         [ 5, 6 ]
+                     *     ]);
+                     * function HighLightFilter(range) {
+                     *     GC.Spread.Sheets.Filter.RowFilterBase.call(this, range);
+                     * }
+                     * HighLightFilter.prototype = new  GC.Spread.Sheets.Filter.RowFilterBase(new GC.Spread.Sheets.Range(-1, -1, -1, -1));
+                     * var doFilterCalled = false;
+                     * HighLightFilter.prototype.onFilter = function(args) {
+                     *     if ( args.action ===  GC.Spread.Sheets.Filter.FilterActionType.filter ) {
+                     *         doFilterCalled = true;
+                     *     }
+                     * };
+                     * sheet.rowFilter(new HighLightFilter(new GC.Spread.Sheets.Range(-1, -1, -1, -1)));
+                     * var condition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.numberCondition, { compareType: GC.Spread.Sheets.ConditionalFormatting.GeneralComparisonOperators.greaterThan, expected: 1 });
+                     * sheet.rowFilter().addFilterItem(0, condition);
+                     * sheet.rowFilter().filter();
+                     * console.log(doFilterCalled); // true
+                     * ```
                      */
                     onFilter(args: GC.Spread.Sheets.Filter.IFilteredArgs): void;
                     /**
                      * Opens the filter dialog when the user clicks the filter button.
                      * @param {GC.Spread.Sheets.IFilterButtonHitInfo} filterButtonHitInfo The hit test information about the filter button.
+                     * @example
+                     * ```
+                     * sheet.setRowCount(3);
+                     * sheet.setColumnCount(2);
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ 1, 2 ],
+                     *         [ 3, 4 ],
+                     *         [ 5, 6 ]
+                     *     ]);
+                     * function HighLightFilter(range) {
+                     *     GC.Spread.Sheets.Filter.RowFilterBase.call(this, range);
+                     * }
+                     * HighLightFilter.prototype = new  GC.Spread.Sheets.Filter.RowFilterBase(new GC.Spread.Sheets.Range(-1, -1, -1, -1));
+                     * HighLightFilter.prototype.openFilterDialog = function(args) {
+                     *     console.log(args.row, args.col);
+                     * };
+                     * sheet.rowFilter(new HighLightFilter(new GC.Spread.Sheets.Range(-1, -1, -1, -1)));
+                     * ```
                      */
                     openFilterDialog(filterButtonHitInfo: GC.Spread.Sheets.IFilterButtonHitInfo): void;
                     /**
                      * Removes the specified filter.
                      * @param {number} col The column index.
+                     * @example
+                     * ```
+                     * sheet.setRowCount(3);
+                     * sheet.setColumnCount(1);
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ 1 ],
+                     *         [ 2 ],
+                     *         [ 3 ]
+                     *     ]);
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range( -1, -1, -1, -1)));
+                     * var condition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.textCondition, {compareType: GC.Spread.Sheets.ConditionalFormatting.TextCompareType.equalsTo, expected: '3'});
+                     * var rowFilter = sheet.rowFilter();
+                     * rowFilter.addFilterItem(0, condition);
+                     * rowFilter.removeFilterItems(0);
+                     * ```
                      */
                     removeFilterItems(col: number): void;
                     /**
                      * Clears all filters.
+                     * @example
+                     * ```
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(-1, -1, -1, -1)));
+                     * sheet.rowFilter().reset();
+                     * console.log(sheet.rowFilter().isFiltered()); // false
+                     * ```
                      */
                     reset(): void;
                     /**
                      * Sorts the specified column in the specified order.
                      * @param {number} col The column index.
                      * @param {boolean} ascending Set to `true` to sort as ascending.
+                     * @example
+                     * ```
+                     * sheet.setArray(0, 0, [
+                     *     [ 4 ],
+                     *     [ 3 ],
+                     *     [ 2 ],
+                     *     [ 1 ],
+                     *     [ 0 ]
+                     * ]);
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(0, 0, 5, 1)));
+                     * sheet.rowFilter().addFilterItem(0, new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.numberCondition, { compareType: GC.Spread.Sheets.ConditionalFormatting.GeneralComparisonOperators.greaterThan, expected: 2 }));
+                     * sheet.rowFilter().filter(0);
+                     * sheet.rowFilter().sortColumn(0, true);
+                     * ```
                      */
                     sortColumn(col: number,  ascending: boolean): void;
                     /**
@@ -36100,7 +36596,22 @@ declare module GC{
                     toJSON(): Object;
                     /**
                      * Removes the filter from the specified column.
-                     * @param {number} col The index of the column for which to remove the filter; if it is omitted, removes the filter for all columns in the range.
+                     * @param {number} [col] The index of the column for which to remove the filter; if it is omitted, removes the filter for all columns in the range.
+                     * @example
+                     * ```
+                     * sheet.setRowCount(2);
+                     * sheet.setColumnCount(1);
+                     * sheet.setArray(0, 0,
+                     *     [
+                     *         [ "a" ],
+                     *         [ "b" ]
+                     *     ]);
+                     * sheet.rowFilter(new GC.Spread.Sheets.Filter.HideRowFilter(new GC.Spread.Sheets.Range(-1, -1, -1, -1)));
+                     * var condition = new GC.Spread.Sheets.ConditionalFormatting.Condition(GC.Spread.Sheets.ConditionalFormatting.ConditionType.textCondition, {compareType: GC.Spread.Sheets.ConditionalFormatting.TextCompareType.equalsTo,expected: 'a'});
+                     * var rowFilter = sheet.rowFilter();
+                     * rowFilter.addFilterItem(0, condition);
+                     * rowFilter.unfilter();
+                     * ```
                      */
                     unfilter(col?: number): void;
                 }
@@ -36138,7 +36649,7 @@ declare module GC{
                     typeName: string;
                     /**
                      * Gets or sets whether to disable moving the floating object.
-                     * @param {boolean} value The setting for whether to disable moving the floating object.
+                     * @param {boolean} [value] The setting for whether to disable moving the floating object.
                      * @returns {boolean | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the setting for whether to disable moving the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36157,7 +36668,7 @@ declare module GC{
                     allowMove(value?: boolean): any;
                     /**
                      * Gets or sets whether to disable resizing the floating object.
-                     * @param {boolean} value The setting for whether to disable resizing the floating object.
+                     * @param {boolean} [value] The setting for whether to disable resizing the floating object.
                      * @returns {boolean | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the setting for whether to disable resizing the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36176,24 +36687,70 @@ declare module GC{
                     allowResize(value?: boolean): any;
                     /**
                      * Gets or sets the alternative text of the floating object for screen readers.
-                     * @param {string} value The alternative text of the floating object.
+                     * @param {string} [value] The alternative text of the floating object.
                      * @returns {string} The alternative text of the floating object.
+                     * @example
+                     * ```
+                     * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject('f1', 10, 10, 60, 64);
+                     * var btn = document.createElement('button');
+                     * btn.style.width = "60px";
+                     * btn.style.height = "30px";
+                     * btn.innerText = "button";
+                     * customFloatingObject.content(btn);
+                     * customFloatingObject.alt("A button");
+                     * activeSheet.floatingObjects.add(customFloatingObject);
+                     * ```
                      */
                     alt(value?: string): any;
                     /**
                      * Gets a copy of the current content of the instance.
                      * @returns {HTMLElement} A copy of the current content of the instance.
+                     * @example
+                     * ```
+                     * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject('f1', 10, 10, 64, 30);
+                     * customFloatingObject.content(createButton('button 1', '64px', '30px'));
+                     * activeSheet.floatingObjects.add(customFloatingObject);
+                     *
+                     * var btn = customFloatingObject.cloneContent();
+                     * btn.innerText = 'button 2';
+                     * customFloatingObject.content(btn);
+                     *
+                     * function createButton (text, width, height) {
+                     *     var btn = document.createElement('button');
+                     *     btn.style.width = width;
+                     *     btn.style.height = height;
+                     *     btn.innerText = text;
+                     *     return btn;
+                     * }
+                     * ```
                      */
                     cloneContent(): HTMLElement;
                     /**
                      * Gets or sets the content of the custom floating object.
-                     * @param {HTMLElement} value The content of the custom floating object.
+                     * @param {HTMLElement} [value] The content of the custom floating object.
                      * @returns {HTMLElement | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the content of the custom floating object; otherwise, returns the floating object.
+                     * @example
+                     * ```
+                     * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject('f1', 10, 10, 64, 30);
+                     * customFloatingObject.content(createButton('button 1', '64px', '30px'));
+                     * activeSheet.floatingObjects.add(customFloatingObject);
+                     *
+                     * console.log(customFloatingObject.content()); // get current content, the result is button element with the text "button 1".
+                     * customFloatingObject.content(createButton('button 2', '64px', '30px')); // set new content.
+                     *
+                     * function createButton (text, width, height) {
+                     *     var btn = document.createElement('button');
+                     *     btn.style.width = width;
+                     *     btn.style.height = height;
+                     *     btn.innerText = text;
+                     *     return btn;
+                     * }
+                     * ```
                      */
                     content(value?: HTMLElement): any;
                     /**
                      * Gets or sets whether the object moves when hiding or showing, resizing, or moving rows or columns.
-                     * @param {boolean} value The value indicates whether the object moves when hiding or showing, resizing, or moving rows or columns.
+                     * @param {boolean} [value] The value indicates whether the object moves when hiding or showing, resizing, or moving rows or columns.
                      * @returns {boolean | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns whether this floating object dynamically moves; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36213,7 +36770,7 @@ declare module GC{
                     dynamicMove(value?: boolean): any;
                     /**
                      * Gets or sets whether the size of the object changes when hiding or showing, resizing, or moving rows or columns.
-                     * @param {boolean} value The value indicates whether the size of the object changes when hiding or showing, resizing, or moving rows or columns.
+                     * @param {boolean} [value] The value indicates whether the size of the object changes when hiding or showing, resizing, or moving rows or columns.
                      * @returns {boolean | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns whether this floating object dynamically changes size; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36233,11 +36790,11 @@ declare module GC{
                     dynamicSize(value?: boolean): any;
                     /**
                      * Gets or sets the end column index of the floating object position.
-                     * @param {number} value The end column index of the floating object position.
+                     * @param {number} [value] The end column index of the floating object position.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the end column index of the floating object position; otherwise, returns the floating object.
                      * @example
                      * ```
-                     * //This example creates a floating object.
+                     * //Creates a floating object.
                      * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject("f1", 10, 10, 60, 64);
                      * var btn = document.createElement('button');
                      * btn.style.width = "60px";
@@ -36245,11 +36802,12 @@ declare module GC{
                      * btn.innerText = "button";
                      * customFloatingObject.content(btn);
                      * activeSheet.floatingObjects.add(customFloatingObject);
-                     * //takes effect when added into the sheet.
+                     * //Position the upper left corner of the floating object by cell anchors.
                      * customFloatingObject.startRow(2);
                      * customFloatingObject.startColumn(2);
                      * customFloatingObject.startRowOffset(10);
                      * customFloatingObject.startColumnOffset(10);
+                     * //Position the lower right corner of the floating object by cell anchors.
                      * customFloatingObject.endRow(7);
                      * customFloatingObject.endColumn(5);
                      * customFloatingObject.endRowOffset(10);
@@ -36259,11 +36817,11 @@ declare module GC{
                     endColumn(value?: number): any;
                     /**
                      * Gets or sets the offset relative to the end column of the floating object.
-                     * @param {number} value The offset relative to the end column of the floating object.
+                     * @param {number} [value] The offset relative to the end column of the floating object.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the offset relative to the end column of the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
-                     * //This example creates a floating object.
+                     * //Creates a floating object.
                      * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject("f1", 10, 10, 60, 64);
                      * var btn = document.createElement('button');
                      * btn.style.width = "60px";
@@ -36271,11 +36829,12 @@ declare module GC{
                      * btn.innerText = "button";
                      * customFloatingObject.content(btn);
                      * activeSheet.floatingObjects.add(customFloatingObject);
-                     * //takes effect when added into the sheet.
+                     * //Position the upper left corner of the floating object by cell anchors.
                      * customFloatingObject.startRow(2);
                      * customFloatingObject.startColumn(2);
                      * customFloatingObject.startRowOffset(10);
                      * customFloatingObject.startColumnOffset(10);
+                     * //Position the lower right corner of the floating object by cell anchors.
                      * customFloatingObject.endRow(7);
                      * customFloatingObject.endColumn(5);
                      * customFloatingObject.endRowOffset(10);
@@ -36285,11 +36844,11 @@ declare module GC{
                     endColumnOffset(value?: number): any;
                     /**
                      * Gets or sets the end row index of the floating object position.
-                     * @param {number} value The end row index of the floating object position.
+                     * @param {number} [value] The end row index of the floating object position.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the end row index of the floating object position; otherwise, returns the floating object.
                      * @example
                      * ```
-                     * //This example creates a floating object.
+                     * //Creates a floating object.
                      * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject("f1", 10, 10, 60, 64);
                      * var btn = document.createElement('button');
                      * btn.style.width = "60px";
@@ -36297,11 +36856,12 @@ declare module GC{
                      * btn.innerText = "button";
                      * customFloatingObject.content(btn);
                      * activeSheet.floatingObjects.add(customFloatingObject);
-                     * //takes effect when added into the sheet.
+                     * //Position the upper left corner of the floating object by cell anchors.
                      * customFloatingObject.startRow(2);
                      * customFloatingObject.startColumn(2);
                      * customFloatingObject.startRowOffset(10);
                      * customFloatingObject.startColumnOffset(10);
+                     * //Position the lower right corner of the floating object by cell anchors.
                      * customFloatingObject.endRow(7);
                      * customFloatingObject.endColumn(5);
                      * customFloatingObject.endRowOffset(10);
@@ -36311,11 +36871,11 @@ declare module GC{
                     endRow(value?: number): any;
                     /**
                      * Gets or sets the offset relative to the end row of the floating object.
-                     * @param {number} value The offset relative to the end row of the floating object.
+                     * @param {number} [value] The offset relative to the end row of the floating object.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the offset relative to the end row of the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
-                     * //This example creates a floating object.
+                     * //Creates a floating object.
                      * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject("f1", 10, 10, 60, 64);
                      * var btn = document.createElement('button');
                      * btn.style.width = "60px";
@@ -36323,11 +36883,12 @@ declare module GC{
                      * btn.innerText = "button";
                      * customFloatingObject.content(btn);
                      * activeSheet.floatingObjects.add(customFloatingObject);
-                     * //takes effect when added into the sheet.
+                     * //Position the upper left corner of the floating object by cell anchors.
                      * customFloatingObject.startRow(2);
                      * customFloatingObject.startColumn(2);
                      * customFloatingObject.startRowOffset(10);
                      * customFloatingObject.startColumnOffset(10);
+                     * //Position the lower right corner of the floating object by cell anchors.
                      * customFloatingObject.endRow(7);
                      * customFloatingObject.endColumn(5);
                      * customFloatingObject.endRowOffset(10);
@@ -36337,7 +36898,7 @@ declare module GC{
                     endRowOffset(value?: number): any;
                     /**
                      * Gets or sets whether the position of the floating object is fixed. When fixedPosition is true, dynamicMove and dynamicSize are disabled.
-                     * @param {boolean} value The value indicates whether the position of the floating object is fixed.
+                     * @param {boolean} [value] The value indicates whether the position of the floating object is fixed.
                      * @returns {boolean | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns whether the position of the floating object is fixed; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36360,7 +36921,7 @@ declare module GC{
                     getHost(): HTMLElement[];
                     /**
                      * Gets or sets the height of a floating object.
-                     * @param {number} value The height of a floating object.
+                     * @param {number} [value] The height of a floating object.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the height of a floating object; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36381,7 +36942,7 @@ declare module GC{
                     height(value?: number): any;
                     /**
                      * Gets or sets whether this floating object is locked.
-                     * @param {boolean} value The value that indicates whether this floating object is locked.
+                     * @param {boolean} [value] The value that indicates whether this floating object is locked.
                      * @returns {boolean | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns whether this floating object is locked; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36403,7 +36964,7 @@ declare module GC{
                     isLocked(value?: boolean): any;
                     /**
                      * Gets or sets whether this floating object is selected.
-                     * @param {boolean} value The value that indicates whether this floating object is selected.
+                     * @param {boolean} [value] The value that indicates whether this floating object is selected.
                      * @returns {boolean | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns whether this floating object is selected; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36421,7 +36982,7 @@ declare module GC{
                     isSelected(value?: boolean): any;
                     /**
                      * Gets or sets whether this floating object is visible.
-                     * @param {boolean} value The value that indicates whether this floating object is visible.
+                     * @param {boolean} [value] The value that indicates whether this floating object is visible.
                      * @returns {boolean | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns whether this floating object is visible; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36441,7 +37002,7 @@ declare module GC{
                     isVisible(value?: boolean): any;
                     /**
                      * Gets the name of the floating object.
-                     * @param {string} value The name of the floating object.
+                     * @param {string} [value] The name of the floating object.
                      * @returns {string | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the name of the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36467,11 +37028,11 @@ declare module GC{
                     refreshContent(): void;
                     /**
                      * Gets or sets the starting column index of the floating object position.
-                     * @param {number} value The starting column index of the floating object position.
+                     * @param {number} [value] The starting column index of the floating object position.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the starting column index of the floating object position; otherwise, returns the floating object.
                      * @example
                      * ```
-                     * //This example creates a floating object.
+                     * //Creates a floating object.
                      * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject("f1", 10, 10, 60, 64);
                      * var btn = document.createElement('button');
                      * btn.style.width = "60px";
@@ -36479,7 +37040,7 @@ declare module GC{
                      * btn.innerText = "button";
                      * customFloatingObject.content(btn);
                      * activeSheet.floatingObjects.add(customFloatingObject);
-                     * //takes effect when added into the sheet.
+                     * //Position the upper left corner of the floating object by cell anchors.
                      * customFloatingObject.startRow(2);
                      * customFloatingObject.startColumn(2);
                      * customFloatingObject.startRowOffset(10);
@@ -36489,11 +37050,11 @@ declare module GC{
                     startColumn(value?: number): any;
                     /**
                      * Gets or sets the offset relative to the start column of the floating object.
-                     * @param {number} value The offset relative to the start column of the floating object.
+                     * @param {number} [value] The offset relative to the start column of the floating object.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the offset relative to the start column of the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
-                     * //This example creates a floating object.
+                     * //Creates a floating object.
                      * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject("f1", 10, 10, 60, 64);
                      * var btn = document.createElement('button');
                      * btn.style.width = "60px";
@@ -36501,7 +37062,7 @@ declare module GC{
                      * btn.innerText = "button";
                      * customFloatingObject.content(btn);
                      * activeSheet.floatingObjects.add(customFloatingObject);
-                     * //takes effect when added into the sheet.
+                     * //Position the upper left corner of the floating object by cell anchors.
                      * customFloatingObject.startRow(2);
                      * customFloatingObject.startColumn(2);
                      * customFloatingObject.startRowOffset(10);
@@ -36511,11 +37072,11 @@ declare module GC{
                     startColumnOffset(value?: number): any;
                     /**
                      * Gets or sets the starting row index of the floating object position.
-                     * @param {number} value The starting row index of the floating object position.
+                     * @param {number} [value] The starting row index of the floating object position.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the starting row index of the floating object position; otherwise, returns the floating object.
                      * @example
                      * ```
-                     * //This example creates a floating object.
+                     * //Creates a floating object.
                      * var customFloatingObject = new GC.Spread.Sheets.FloatingObjects.FloatingObject("f1", 10, 10, 60, 64);
                      * var btn = document.createElement('button');
                      * btn.style.width = "60px";
@@ -36523,7 +37084,7 @@ declare module GC{
                      * btn.innerText = "button";
                      * customFloatingObject.content(btn);
                      * activeSheet.floatingObjects.add(customFloatingObject);
-                     * //takes effect when added into the sheet.
+                     * //Position the upper left corner of the floating object by cell anchors.
                      * customFloatingObject.startRow(2);
                      * customFloatingObject.startColumn(2);
                      * customFloatingObject.startRowOffset(10);
@@ -36533,7 +37094,7 @@ declare module GC{
                     startRow(value?: number): any;
                     /**
                      * Gets or sets the offset relative to the start row of the floating object.
-                     * @param {number} value The offset relative to the start row of the floating object.
+                     * @param {number} [value] The offset relative to the start row of the floating object.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the offset relative to the start row of the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36545,7 +37106,7 @@ declare module GC{
                      * btn.innerText = "button";
                      * customFloatingObject.content(btn);
                      * activeSheet.floatingObjects.add(customFloatingObject);
-                     * //takes effect when added into the sheet.
+                     * //Position the upper left corner of the floating object by cell anchors.
                      * customFloatingObject.startRow(2);
                      * customFloatingObject.startColumn(2);
                      * customFloatingObject.startRowOffset(10);
@@ -36555,7 +37116,7 @@ declare module GC{
                     startRowOffset(value?: number): any;
                     /**
                      * Gets or sets the width of a floating object.
-                     * @param {number} value The width of a floating object.
+                     * @param {number} [value] The width of a floating object.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the width of a floating object; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36576,7 +37137,7 @@ declare module GC{
                     width(value?: number): any;
                     /**
                      * Gets or sets the horizontal location of the floating object.
-                     * @param {number} value The horizontal location of the floating object.
+                     * @param {number} [value] The horizontal location of the floating object.
                      * @return {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the horizontal location of the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36597,7 +37158,7 @@ declare module GC{
                     x(value?: number): any;
                     /**
                      * Gets or sets the vertical location of the floating object.
-                     * @param {number} value The vertical location of the floating object.
+                     * @param {number} [value] The vertical location of the floating object.
                      * @return {number | GC.Spread.Sheets.FloatingObjects.FloatingObject} If no value is set, returns the vertical location of the floating object; otherwise, returns the floating object.
                      * @example
                      * ```
@@ -36666,6 +37227,28 @@ declare module GC{
                     all(): GC.Spread.Sheets.FloatingObjects.FloatingObject[];
                     /**
                      * Removes all floating objects in the sheet.
+                     * @example
+                     * ```
+                     * var f1 = new GC.Spread.Sheets.FloatingObjects.FloatingObject('f1', 10, 10, 64, 30);
+                     * f1.content(createButton('button 1', '64px', '30px'));
+                     * activeSheet.floatingObjects.add(f1);
+                     *
+                     * var f2 = new GC.Spread.Sheets.FloatingObjects.FloatingObject('f2', 100, 10, 64, 30);
+                     * f2.content(createButton('button 2', '64px', '30px'));
+                     * activeSheet.floatingObjects.add(f2);
+                     *
+                     * console.log(activeSheet.floatingObjects.all().length); // result is 2
+                     * activeSheet.floatingObjects.clear(); // removes all floating objects.
+                     * console.log(activeSheet.floatingObjects.all().length); // result is 0
+                     *
+                     * function createButton (text, width, height) {
+                     *     var btn = document.createElement('button');
+                     *     btn.style.width = width;
+                     *     btn.style.height = height;
+                     *     btn.innerText = text;
+                     *     return btn;
+                     * }
+                     * ```
                      */
                     clear(): void;
                     /**
@@ -36740,49 +37323,43 @@ declare module GC{
                     constructor(name: string,  src: string,  x: number,  y: number,  width: number,  height: number);
                     /**
                      * Gets or sets the background color of the picture.
-                     * @param {string} value The backcolor of the picture.
+                     * @param {string} [value] The backcolor of the picture.
                      * @returns {string | GC.Spread.Sheets.FloatingObjects.Picture} If no value is set, returns the backcolor of the picture; otherwise, returns the picture.
                      * @example
                      * ```
                      * //This example sets the backcolor of the picture.
-                     * activeSheet.pictures.add("f2","Event.png",2,2,10,10);
-                     * var picture = activeSheet.pictures.get("f2");
-                     * picture.pictureStretch(GC.Spread.Sheets.ImageLayout.stretch);
-                     * picture.backColor("Blue");
+                     * var picture = activeSheet.pictures.add("f2","Event.png",50,50,100,100);
+                     * picture.borderStyle("solid");
                      * picture.borderWidth(2);
-                     * picture.borderColor("Red");
+                     * picture.borderColor("red");
                      * ```
                      */
                     backColor(value?: string): any;
                     /**
                      * Gets or sets the border color of the picture.
-                     * @param {string} value The border color of the picture.
+                     * @param {string} [value] The border color of the picture.
                      * @returns {string | GC.Spread.Sheets.FloatingObjects.Picture} If no value is set, returns the border color of the picture; otherwise, returns the picture.
                      * @example
                      * ```
                      * //This example sets the border color of the picture.
-                     * activeSheet.pictures.add("f2","Event.png",2,2,10,10);
-                     * var picture = activeSheet.pictures.get("f2");
-                     * picture.pictureStretch(GC.Spread.Sheets.ImageLayout.stretch);
-                     * picture.backColor("Blue");
+                     * var picture = activeSheet.pictures.add("f2","Event.png",50,50,100,100);
+                     * picture.borderStyle("solid");
                      * picture.borderWidth(2);
-                     * picture.borderColor("Red");
+                     * picture.borderColor("red");
                      * ```
                      */
                     borderColor(value?: string): any;
                     /**
                      * Gets or sets the border radius of the picture.
-                     * @param {number} value The border radius of the picture.
+                     * @param {number} [value] The border radius of the picture.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.Picture} If no value is set, returns the border radius of the picture; otherwise, returns the picture.
                      * @example
                      * ```
                      * //This example uses the borderRadius method.
-                     * activeSheet.pictures.add("f2","Event.png",2,2,10,10);
-                     * var picture = activeSheet.pictures.get("f2");
-                     * picture.pictureStretch(GC.Spread.Sheets.ImageLayout.center);
-                     * picture.backColor("Blue");
+                     * var picture = activeSheet.pictures.add("f2","Event.png",50,50,100,100);
+                     * picture.backColor("blue");
                      * picture.borderWidth(2);
-                     * picture.borderColor("Red");
+                     * picture.borderColor("red");
                      * picture.borderStyle("dotted");
                      * picture.borderRadius(5);
                      * ```
@@ -36790,35 +37367,29 @@ declare module GC{
                     borderRadius(value?: number): any;
                     /**
                      * Gets or sets the border style of the picture.
-                     * @param {string} value The css border style of the picture, such as dotted, dashed, solid, and so on.
+                     * @param {string} [value] The css border style of the picture, such as dotted, dashed, solid, and so on.
                      * @returns {string | GC.Spread.Sheets.FloatingObjects.Picture} If no value is set, returns the border style of the picture; otherwise, returns the picture.
                      * @example
                      * ```
                      * //This example uses the borderStyle method.
-                     * activeSheet.pictures.add("f2","Event.png",2,2,10,10);
-                     * var picture = activeSheet.pictures.get("f2");
-                     * picture.pictureStretch(GC.Spread.Sheets.ImageLayout.center);
-                     * picture.backColor("Blue");
-                     * picture.borderWidth(2);
-                     * picture.borderColor("Red");
+                     * var picture = activeSheet.pictures.add("f2","Event.png",50,50,100,100);
                      * picture.borderStyle("dotted");
-                     * picture.borderRadius(5);
+                     * picture.borderWidth(2);
+                     * picture.borderColor("red");
                      * ```
                      */
                     borderStyle(value?: string): any;
                     /**
                      * Gets or sets the border width of the picture.
-                     * @param {number} value The border width of the picture.
+                     * @param {number} [value] The border width of the picture.
                      * @returns {number | GC.Spread.Sheets.FloatingObjects.Picture} If no value is set, returns the border width of the picture; otherwise, returns the picture.
                      * @example
                      * ```
                      * //This example uses the borderWidth method.
-                     * activeSheet.pictures.add("f2","Event.png",2,2,10,10);
-                     * var picture = activeSheet.pictures.get("f2");
-                     * picture.pictureStretch(GC.Spread.Sheets.ImageLayout.stretch);
-                     * picture.backColor("Blue");
+                     * var picture = activeSheet.pictures.add("f2","Event.png",50,50,100,100);
+                     * picture.borderStyle("solid");
                      * picture.borderWidth(2);
-                     * picture.borderColor("Red");
+                     * picture.borderColor("red");
                      * ```
                      */
                     borderWidth(value?: number): any;
@@ -36856,24 +37427,27 @@ declare module GC{
                     getOriginalWidth(): number;
                     /**
                      * Gets or sets the stretch of the picture.
-                     * @param {GC.Spread.Sheets.ImageLayout} value The stretch of the picture.
+                     * @param {GC.Spread.Sheets.ImageLayout} [value] The stretch of the picture.
                      * @returns {GC.Spread.Sheets.ImageLayout | GC.Spread.Sheets.FloatingObjects.Picture} If no value is set, returns the stretch of the picture; otherwise, returns the picture.
                      * @example
                      * ```
                      * //This example uses the pictureStretch method.
-                     * activeSheet.pictures.add("f2","Event.png",2,2,10,10);
-                     * var picture = activeSheet.pictures.get("f2");
+                     * var picture = activeSheet.pictures.add("f2","Event.png",50,50,100,100);
                      * picture.pictureStretch(GC.Spread.Sheets.ImageLayout.stretch);
-                     * picture.backColor("Blue");
-                     * picture.borderWidth(2);
-                     * picture.borderColor("Red");
+                     * picture.backColor("blue");
                      * ```
                      */
                     pictureStretch(value?: GC.Spread.Sheets.ImageLayout): any;
                     /**
                      * Gets or sets the src of the picture.
-                     * @param {string} value The src of the picture.
+                     * @param {string} [value] The src of the picture.
                      * @returns {string | GC.Spread.Sheets.FloatingObjects.Picture} If no value is set, returns the src of the picture; otherwise, returns the picture.
+                     * @example
+                     * ```
+                     * var pic = sheet.pictures.add("Picture 1", "Event.png", 100, 50, 200, 200);
+                     * var src = pic.src(); // get current image source, the result is "Event.png".
+                     * pic.src("tsoutline.png"); // set new image source.
+                     * ```
                      */
                     src(value?: string): any;
                 }
@@ -39350,26 +39924,64 @@ declare module GC{
                     constructor(model: GC.Spread.Sheets.Outlines.Outline,  start: number,  end: number,  level: number);
                     /** The children of the group.
                      * @type {Array}
+                     * @example
+                     * ```
+                     * activeSheet.rowOutlines.group(2, 10);
+                     * activeSheet.rowOutlines.group(4, 2);
+                     * var outlineInfo = activeSheet.rowOutlines.find(2, 0);
+                     * console.log(outlineInfo.children[0] === activeSheet.rowOutlines.find(4, 1)); // true
+                     * ```
                      */
                     children: any[];
                     /** The end index of the group.
                      * @type {number}
+                     * @example
+                     * ```
+                     * activeSheet.rowOutlines.group(2, 10);
+                     * var outlineInfo = activeSheet.rowOutlines.find(2, 0);
+                     * console.log(outlineInfo.end); // 11
+                     * ```
                      */
                     end: number;
                     /** The level of the group.
                      * @type {number}
+                     * @example
+                     * ```
+                     * activeSheet.rowOutlines.group(2, 10);
+                     * var outlineInfo = activeSheet.rowOutlines.find(2, 0);
+                     * console.log(outlineInfo.level); // 0
+                     * ```
                      */
                     level: number;
                     /** The owner of the group.
                      * @type {GC.Spread.Sheets.Outlines.Outline}
+                     * @example
+                     * ```
+                     * activeSheet.rowOutlines.group(2, 10);
+                     * var outlineInfo = activeSheet.rowOutlines.find(2, 0);
+                     * console.log(outlineInfo.model === activeSheet.rowOutlines); // true
+                     * ```
                      */
                     model: GC.Spread.Sheets.Outlines.Outline;
                     /** The parent of the group.
                      * @type {GC.Spread.Sheets.Outlines.OutlineInfo}
+                     * @example
+                     * ```
+                     * activeSheet.rowOutlines.group(2, 10);
+                     * activeSheet.rowOutlines.group(4, 2);
+                     * var outlineInfo = activeSheet.rowOutlines.find(4, 1);
+                     * console.log(outlineInfo.parent === activeSheet.rowOutlines.find(2, 0)); // true
+                     * ```
                      */
                     parent: GC.Spread.Sheets.Outlines.OutlineInfo;
                     /** The start index of the group.
                      * @type {number}
+                     * @example
+                     * ```
+                     * activeSheet.rowOutlines.group(2, 10);
+                     * var outlineInfo = activeSheet.rowOutlines.find(2, 0);
+                     * console.log(outlineInfo.start); // 2
+                     * ```
                      */
                     start: number;
                     /**
@@ -39381,12 +39993,33 @@ declare module GC{
                      * Compares this instance to a specified OutlineInfo object and returns an indication of their relative values.
                      * @param {number} index The index of the group item.
                      * @returns {boolean} `true` if the range group contains the specified index; otherwise, `false`.
+                     * @example
+                     * ```
+                     * activeSheet.rowOutlines.group(2, 10);
+                     * activeSheet.rowOutlines.group(4, 2);
+                     * var outlineInfo1 = activeSheet.rowOutlines.find(2, 0);
+                     * var outlineInfo2 = activeSheet.rowOutlines.find(4, 1);
+                     * console.log(outlineInfo1.contains(5)); // true;
+                     * console.log(outlineInfo2.contains(5)); // true;
+                     * console.log(outlineInfo1.contains(6)); // true;
+                     * console.log(outlineInfo2.contains(6)); // false;
+                     * ```
                      */
                     contains(index: number): boolean;
                     /**
                      * Gets or sets the state of this outline (range group).
                      * @param {GC.Spread.Sheets.Outlines.OutlineState} [value] The state of this outline (range group).
                      * @returns {GC.Spread.Sheets.Outlines.OutlineState} The state of this outline (range group).
+                     * @example
+                     * ```
+                     * activeSheet.rowOutlines.group(2, 10);
+                     * activeSheet.rowOutlines.group(4, 2);
+                     * var outlineInfo = activeSheet.rowOutlines.find(4, 1);
+                     * console.log(outlineInfo.state()); // equals to GC.Spread.Sheets.Outlines.OutlineState.expanded
+                     * outlineInfo.state(GC.Spread.Sheets.Outlines.OutlineState.collapsed);
+                     * console.log(outlineInfo.state()); // equals to GC.Spread.Sheets.Outlines.OutlineState.collapsed
+                     * activeSheet.repaint(); // the outline is collapsed
+                     * ```
                      */
                     state(value?: GC.Spread.Sheets.Outlines.OutlineState): GC.Spread.Sheets.Outlines.OutlineState;
                 }
@@ -39489,17 +40122,41 @@ declare module GC{
 
 
                 export interface PrintMargins{
+                    /**
+                     * The top margin, in hundredths of an inch.
+                     */
                     top: number;
+                    /**
+                     * The bottom margin, in hundredths of an inch.
+                     */
                     bottom: number;
+                    /**
+                     * The left margin, in hundredths of an inch.
+                     */
                     left: number;
+                    /**
+                     * The right margin, in hundredths of an inch.
+                     */
                     right: number;
+                    /**
+                     * The header offset, in hundredths of an inch.
+                     */
                     header: number;
+                    /**
+                     * The footer offset, in hundredths of an inch.
+                     */
                     footer: number;
                 }
 
 
                 export interface PrintSize{
+                    /**
+                     * The width of the size, in hundredths of an inch.
+                     */
                     height: number;
+                    /**
+                     * The height of the size, in hundredths of an inch.
+                     */
                     width: number;
                 }
 
@@ -40404,12 +41061,6 @@ declare module GC{
                     /**
                      * Gets or sets the margins for printing, in hundredths of an inch.
                      * @param {GC.Spread.Sheets.Print.PrintMargins} [value] The margins for printing.
-                     * @param {number} [value.top] - The top margin, in hundredths of an inch.
-                     * @param {number} [value.bottom] -  bottom The bottom margin, in hundredths of an inch.
-                     * @param {number} [value.left] - left The left margin, in hundredths of an inch.
-                     * @param {number} [value.right] - right The right margin, in hundredths of an inch.
-                     * @param {number} [value.header] - header The header offset, in hundredths of an inch.
-                     * @param {number} [value.footer] - footer The footer offset, in hundredths of an inch.
                      * @returns {GC.Spread.Sheets.Print.PrintMargins | GC.Spread.Sheets.Print.PrintInfo} If no value is set, returns the margins for printing; otherwise, returns the print setting information.
                      * @example
                      * ```
@@ -40505,7 +41156,7 @@ declare module GC{
                     /**
                      * Gets or sets the paper size for printing.
                      * @param {GC.Spread.Sheets.Print.PaperSize} [value] The paper size for printing.
-                     * @param @returns {GC.Spread.Sheets.Print.PaperSize | GC.Spread.Sheets.Print.PrintInfo} If no value is set, returns the paper size for printing; otherwise, returns the print setting information.
+                     * @returns {GC.Spread.Sheets.Print.PaperSize | GC.Spread.Sheets.Print.PrintInfo} If no value is set, returns the paper size for printing; otherwise, returns the print setting information.
                      * @example
                      * ```
                      * activeSheet.setArray(0, 0, new Array(20).fill(["sample text"]));
@@ -44273,6 +44924,15 @@ declare module GC{
                     allowMove: (value?: boolean, shouldCallback?: boolean) => boolean | ISlicer;
                 }
 
+
+                /**
+                 * @typedef GC.Spread.Sheets.Slicers.SlicerBorderStyle
+                 * @type {"empty" | "thin" | "medium" | "dashed" | "dotted" | "thick" | "double" | "hair" | "mediumDashed" | "dashDot" | "mediumDashDot" | "dashDotDot" | "mediumDashDotDot" | "slantedDashDot"}
+                 * @description The border type of slicer border style.
+                 */
+                export type SlicerBorderStyle = 
+                    "empty" | "thin" | "medium" | "dashed" | "dotted" | "thick" | "double" | "hair" | "mediumDashed" | "dashDot" | "mediumDashDot" | "dashDotDot" | "mediumDashDotDot" | "slantedDashDot"
+                
                 /**
                  * Specifies which type to add a slicer
                  * @enum {number}
@@ -45972,11 +46632,11 @@ declare module GC{
                      * table.setColumnName(4, dataColumns[4]);
                      * //style info
                      * var hstyle = new GC.Spread.Sheets.Slicers.SlicerStyleInfo();
-                     * var border = new GC.Spread.Sheets.Slicers.SlicerBorder(3, "dashed", "green");
+                     * var border = new GC.Spread.Sheets.Slicers.SlicerBorder(3, 'dashed', "green");
                      *
-                     * console.log(border.borderStyle()); // dashed
-                     * border.borderStyle("mediumDashDot");
-                     * console.log(border.borderStyle()); // mediumDashDot
+                     * console.log(border.borderStyle()); // 'dashed'
+                     * border.borderStyle('mediumDashDot');
+                     * console.log(border.borderStyle()); // 'mediumDashDot'
                      *
                      * hstyle.borderBottom(border);
                      * var style1 = new GC.Spread.Sheets.Slicers.SlicerStyle();
@@ -48869,6 +49529,15 @@ declare module GC{
                     /**
                      * Clones a sparkline.
                      * @returns {GC.Spread.Sheets.Sparklines.Sparkline} The cloned sparkline.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [-1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let sparkline = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, new GC.Spread.Sheets.Sparklines.SparklineSetting());
+                     *
+                     * let sparkline2 = sparkline.clone();
+                     * ```
                      */
                     clone(): GC.Spread.Sheets.Sparklines.Sparkline;
                     /**
@@ -49050,8 +49719,21 @@ declare module GC{
                     displayDateAxis(value?: boolean): any;
                     /**
                      * Gets or sets the sparkline group.
-                     * @param {GC.Spread.Sheets.Sparklines.SparklineGroup} value The sparkline group.
+                     * @param {GC.Spread.Sheets.Sparklines.SparklineGroup} [value] The sparkline group.
                      * @returns {GC.Spread.Sheets.Sparklines.SparklineGroup | GC.Spread.Sheets.Sparklines.Sparkline} If no value is set, returns the sparkline group; otherwise, returns the sparkline.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * sheet.groupSparkline([sparkline1,sparkline2]);
+                     *
+                     * let sparklineGroup = sparkline1.group();
+                     * console.log(sparklineGroup.count()) // 2
+                     * ```
                      */
                     group(value?: GC.Spread.Sheets.Sparklines.SparklineGroup): any;
                     /**
@@ -49065,14 +49747,39 @@ declare module GC{
                     paintSparkline(ctx: CanvasRenderingContext2D,  x: number,  y: number,  w: number,  h: number): void;
                     /**
                      * Gets or sets the sparkline setting of the cell.
-                     * @param {GC.Spread.Sheets.Sparklines.SparklineSetting} value The sparkline setting.
+                     * @param {GC.Spread.Sheets.Sparklines.SparklineSetting} [value] The sparkline setting.
                      * @returns {GC.Spread.Sheets.Sparklines.SparklineSetting  | GC.Spread.Sheets.Sparklines.Sparkline} If no value is set, returns the sparkline setting; otherwise, returns the sparkline.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [-1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let sparkline = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, new GC.Spread.Sheets.Sparklines.SparklineSetting());
+                     *
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * setting.options.showMarkers = true;
+                     * setting.options.displayXAxis = true;
+                     * setting.options.seriesColor = "Text 2 1";
+                     * setting.options.firstMarkerColor = "Text 2 3";
+                     * setting.options.axisColor ="Text 1 1";
+                     *
+                     * sparkline.setting(setting);
+                     * ```
                      */
                     setting(value?: GC.Spread.Sheets.Sparklines.SparklineSetting): any;
                     /**
                      * Gets or sets the type of the sparkline.
-                     * @param {GC.Spread.Sheets.Sparklines.SparklineType} value The sparkline type.
+                     * @param {GC.Spread.Sheets.Sparklines.SparklineType} [value] The sparkline type.
                      * @returns {GC.Spread.Sheets.Sparklines.SparklineType | GC.Spread.Sheets.Sparklines.Sparkline} If no value is set, returns the sparkline type; otherwise, returns the sparkline.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [-1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let sparkline = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, new GC.Spread.Sheets.Sparklines.SparklineSetting());
+                     *
+                     * sparkline.sparklineType(GC.Spread.Sheets.Sparklines.SparklineType.column);
+                     * ```
                      */
                     sparklineType(value?: GC.Spread.Sheets.Sparklines.SparklineType): any;
                 }
@@ -49139,40 +49846,133 @@ declare module GC{
                     /**
                      * Adds a sparkline to the group.
                      * @param {GC.Spread.Sheets.Sparklines.Sparkline} item The sparkline item.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline3 = sheet.setSparkline(11, 6, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.column, setting);
+                     * let sparklineGroup = sheet.groupSparkline([sparkline1,sparkline2]);
+                     * // add a sparkline to sparkline group
+                     * sparklineGroup.add(sparkline3);
+                     * ```
                      */
                     add(item: GC.Spread.Sheets.Sparklines.Sparkline): void;
                     /**
                      * Clones the current sparkline group.
                      * @returns {GC.Spread.Sheets.Sparklines.SparklineGroup} The cloned sparkline group.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparklineGroup = sheet.groupSparkline([sparkline1,sparkline2]
+                     *
+                     * let sparklineGroup2 = sparklineGroup.clone();
+                     * ```
                      */
                     clone(): GC.Spread.Sheets.Sparklines.SparklineGroup;
                     /**
                      * Determines whether the group contains a specific value.
                      * @param {GC.Spread.Sheets.Sparklines.Sparkline} item The object to locate in the group.
                      * @returns {boolean} `true` if the item is found in the group; otherwise, `false`.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline3 = sheet.setSparkline(11, 6, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparklineGroup = sheet.groupSparkline([sparkline1,sparkline2]);
+                     *
+                     * console.log(sparklineGroup.contains(sparkline1)); // true
+                     * console.log(sparklineGroup.contains(sparkline3)); // false
+                     * ```
                      */
                     contains(item: GC.Spread.Sheets.Sparklines.Sparkline): boolean;
                     /**
                      * Represents the count of the sparkline group innerlist.
                      * @returns {number} The sparkline count in the group.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparklineGroup = sheet.groupSparkline([sparkline1,sparkline2]);
+                     *
+                     * console.log(sparklineGroup.count()); // 2
+                     * ```
                      */
                     count(): number;
                     /**
                      * Represents the date axis data.
-                     * @param {GC.Spread.Sheets.Range} value The date axis data.
+                     * @param {GC.Spread.Sheets.Range} [value] The date axis data.
                      * @returns {GC.Spread.Sheets.Range | undefined} If no value is set, returns the date axis data; otherwise, returns undefined.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [-1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparklineGroup = sheet.groupSparkline([sparkline1,sparkline2]);
+                     *
+                     * sheet.setArray(0, 1, [1,4,6,5,3,6,10,2]);
+                     * sparklineGroup.dateAxisData(new GC.Spread.Sheets.Range(0, 1, 8, 1));
+                     * console.log(sparklineGroup.dateAxisData());
+                     * ```
                      */
                     dateAxisData(value?: GC.Spread.Sheets.Range): any;
                     /**
                      * Represents the date axis orientation.
-                     * @param {GC.Spread.Sheets.Sparklines.DataOrientation} value The date axis orientation.
+                     * @param {GC.Spread.Sheets.Sparklines.DataOrientation} [value] The date axis orientation.
                      * @returns {GC.Spread.Sheets.Sparklines.DataOrientation | undefined} If no value is set, returns the date axis orientation; otherwise, returns undefined.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [-1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparklineGroup = sheet.groupSparkline([sparkline1,sparkline2]);
+                     *
+                     * sheet.setArray(0, 1, [1,4,6,5,3,6,10,2]);
+                     * sparklineGroup.dateAxisData(new GC.Spread.Sheets.Range(0, 1, 8, 1));
+                     * sparklineGroup.dateAxisOrientation(GC.Spread.Sheets.Sparklines.DataOrientation.Vertical);
+                     * ```
                      */
                     dateAxisOrientation(value: GC.Spread.Sheets.Sparklines.DataOrientation): any;
                     /**
                      * Removes the first occurrence of a specific object from the group.
                      * @param {GC.Spread.Sheets.Sparklines.Sparkline} item The sparkline item.
                      * @returns {GC.Spread.Sheets.Sparklines.Sparkline[]} The GC.Spread.Sheets.Sparklines.Sparkline array.
+                     * @example
+                     * ```
+                     * let sheet = spread.getActiveSheet();
+                     * sheet.setArray(0, 0, [-1,2,3,4,3,2,3,5]);
+                     * let dataRange = new GC.Spread.Sheets.Range(0, 0, 8, 1);
+                     * let setting = new GC.Spread.Sheets.Sparklines.SparklineSetting();
+                     * let sparkline1 = sheet.setSparkline(11, 0, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparkline2 = sheet.setSparkline(11, 3, dataRange, GC.Spread.Sheets.Sparklines.DataOrientation.Vertical, GC.Spread.Sheets.Sparklines.SparklineType.line, setting);
+                     * let sparklineGroup = sheet.groupSparkline([sparkline1,sparkline2]);
+                     *
+                     * console.log(sparklineGroup.count()) // 2
+                     * sparklineGroup.remove(sparkline1);
+                     * console.log(sparklineGroup.count()) // 1
+                     * ```
                      */
                     remove(item: GC.Spread.Sheets.Sparklines.Sparkline): GC.Spread.Sheets.Sparklines.Sparkline[];
                 }
@@ -50109,7 +50909,7 @@ declare module GC{
                     /**
                      * Sets a formula to the table's data range with the specified index.
                      * @param {number} tableColumnIndex The column index of the table. The index is zero-based.
-                     * @param {string} formula The data range formula.
+                     * @param {string|null} formula The data range formula.
                      * @returns {GC.Spread.Sheets.Tables.Table} The table.
                      * @example
                      * ```
@@ -50125,9 +50925,10 @@ declare module GC{
                      * activeSheet.getCell(2,1).text("5");
                      * activeSheet.getCell(3,1).text("5");
                      * activeSheet.tables.findByName("Table1").setColumnDataFormula(2, "=[Value1]*[Value2]");
+                     * activeSheet.tables.findByName("Table1").setColumnDataFormula(2, null); // to clear the column data formula
                      * ```
                      */
-                    setColumnDataFormula(tableColumnIndex: number,  formula: string): GC.Spread.Sheets.Tables.Table;
+                    setColumnDataFormula(tableColumnIndex: number,  formula: string | null): GC.Spread.Sheets.Tables.Table;
                     /**
                      * Sets the table footer formula with the specified index.
                      * @param {number} tableColumnIndex The column index of the table footer. The index is zero-based.
@@ -52897,6 +53698,13 @@ declare module GC{
                     /**
                      * Gets all the items that belong to the toolbar.
                      * @returns {GC.Spread.Sheets.Touch.TouchToolStripSeparator[]|GC.Spread.Sheets.Touch.TouchToolStripItem[]} An array that contains all the items in the toolbar.
+                     * @example
+                     * ```
+                     * spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("OP1", "OP1", "op1.png", function(){ }))
+                     * spread.touchToolStrip.add(new GC.Spread.Sheets.Touch.TouchToolStripItem("OP2", "OP2", "op2.png", function(){ }))
+                     * // Gets all the items that belong to the toolbar.
+                     * console.log(spread.touchToolStrip.getItems());
+                     * ```
                      */
                     getItems(): any;
                     /**
@@ -53000,7 +53808,7 @@ declare module GC{
                     constructor(name: string,  text: string,  image: string,  command?: any,  canExecute?: Function);
                     /**
                      * Gets or sets the font of the item text.
-                     * @param {string} value The font of the toolbar item text.
+                     * @param {string} [value] The font of the toolbar item text.
                      * @returns {string | GC.Spread.Sheets.Touch.TouchToolStripItem} If no value is set, returns the font of the item text; otherwise, returns the toolbar item.
                      * @example
                      * ```
@@ -53013,7 +53821,7 @@ declare module GC{
                     font(value?: string): any;
                     /**
                      * Gets or sets the color of the item text.
-                     * @param {string} value The color of the toolbar item text.
+                     * @param {string} [value] The color of the toolbar item text.
                      * @returns {string | GC.Spread.Sheets.Touch.TouchToolStripItem} If no value is set, returns the color of the item text; otherwise, returns the toolbar item.
                      * @example
                      * ```
@@ -53026,7 +53834,7 @@ declare module GC{
                     foreColor(value?: string): any;
                     /**
                      * Gets or sets the source of the item image.
-                     * @param {string} value The path and filename for the item image source.
+                     * @param {string} [value] The path and filename for the item image source.
                      * @returns {string | GC.Spread.Sheets.Touch.TouchToolStripItem} If no value is set, returns the source of the item image; otherwise, returns the toolbar item.
                      * @example
                      * ```
@@ -53042,7 +53850,7 @@ declare module GC{
                     image(value?: string): any;
                     /**
                      * Gets or sets the name of the item.
-                     * @param {string} value The name of the toolbar item.
+                     * @param {string} [value] The name of the toolbar item.
                      * @returns {string | GC.Spread.Sheets.Touch.TouchToolStripItem} If no value is set, returns the name of the item; otherwise, returns the toolbar item.
                      * @example
                      * ```
@@ -53058,7 +53866,7 @@ declare module GC{
                     name(value?: string): any;
                     /**
                      * Gets or sets the text of the item.
-                     * @param {string} value The text of the toolbar item.
+                     * @param {string} [value] The text of the toolbar item.
                      * @returns {string | GC.Spread.Sheets.Touch.TouchToolStripItem} If no value is set, returns the text of the item; otherwise, returns the toolbar item.
                      * @example
                      * ```