创建自定义公式

如果您有定期使用的功能而不是内置功能，或者希望将某些内置功能合并为一个功能，则可以通过定义自己的自定义功能来实现。 可以像调用任何内置函数一样调用它们。 这些自定义函数可以返回指定的值或数组。 以下各节对此进行了解释：

在自定义函数中返回单个值

本示例创建一个返回值的自定义函数。

var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"),{sheetCount:3});
var activeSheet = spread.getActiveSheet();
//  添加自定义函数
// Type =myfunc(1)
//  在单元格中查看结果
function myfunc() {}
myfunc.prototype = new GC.Spread.CalcEngine.Functions.Function("myfunc", 0, 0, {name: "myfunc",description: "This is my first function"});
myfunc.prototype.evaluate = function (args) {
    return 100;}
spread.addCustomFunction(new myfunc());

自定义函数中的返回数组

本示例创建一个返回数组的自定义函数。

<script>
        $(document).ready(function () {
            // 初始化表单
            var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
            // 获取活跃表单
            var sheet = spread.getSheet(0);
            // 允许动态数组
            spread.options.allowDynamicArray = true;
            // 创建工厂函数
            function FactorialFunction() {
                this.name = "FACTORIAL";
                this.maxArgs = 1;
                this.minArgs = 1;
            }
            FactorialFunction.prototype = new GC.Spread.CalcEngine.Functions.Function();
            //计算公式的结果
            FactorialFunction.prototype.evaluate = function (arg) {
                var t = 1;
                var result = [];
                if (arguments.length === 1 && !isNaN(parseInt(arg))) {
                    for (var i = 1; i <= arg; i++) {
                        t = i * t;
                        result.push(t);
                    }
                    //作为函数结果返回CALCArray对象
                    return new GC.Spread.CalcEngine.CalcArray([result]);
                }
                return "#VALUE!";
            };
            //向自定义功能添加描述
            FactorialFunction.prototype.description = function () {
                return {
                    name: "FACTORIAL",
                    description:
                        "This is function which calculates the factorial from 1 and show in different cells of a row",
                };
            };
            var factorial = new FactorialFunction();
            sheet.addCustomFunction(factorial);
            // 合并原点位于单元格（0,0）的三列
            sheet.addSpan(0, 0, 1, 7, GC.Spread.Sheets.SheetArea.viewport);
            sheet.setValue(0, 0, "This custom factorial function calculates the factorial from 1 to 7 ");
            for (var i = 1; i < 8; i++) {
                sheet.setText(2, i - 1, i + "!");
            }
            //设置自定义公式
            sheet.setFormula(3, 0, "=Factorial(7)");
            var style = new GC.Spread.Sheets.Style();
            style.font = "bold 12px Arial";
            style.foreColor = "white";
            style.backColor = "#5B9BD5";
            style.hAlign = GC.Spread.Sheets.HorizontalAlign.center;
            style.vAlign = GC.Spread.Sheets.VerticalAlign.center;
            sheet.setStyle(0, 0, style, GC.Spread.Sheets.SheetArea.viewport);
        });
    </script>