Excel JS自定义函数不返回矩阵

Question

我正在尝试实现一个返回字符串矩阵的 Excel 自定义函数 (JavaScript)。

根据Create custom functions in Excel (Preview) resultDimensionality 必须设置为 matrix在这种情况下。

为了简单起见，我刚刚从文档中复制了示例以返回这样的数组:

function getstringmatrix () {
    return [["first","row"],["second","row"],["third","row"]];
}    
Excel.Script.CustomFunctions["MYFUNCTIONS"]["GETSTRINGMATRIX"] = {
    call: getstringmatrix,
    result: {
        resultType: Excel.CustomFunctionValueType.string,
        resultDimensionality: Excel.CustomFunctionDimensionality.matrix,
    },
    parameters: [ ],
    options:{ batch: false, stream: false }
};

将函数 =MYFUNCTIONS.GETSTRINGMATRIX() 插入 Excel 单元格时，此单元格将填充字符串“first”。但预期的第二列和另外两行根本没有填充!

Answer 1

您创建的函数应该在 Array Formula 中使用在 Excel 中。数组公式是一种高级类型的公式，要求用户以特定方式输入它们。

1. 首先，选择您想要公式输出的单元格范围(根据您的情况，选择 3 行 2 列的范围)
2. 然后输入公式:=MYFUNCTIONS.GETSTRINGMATRIX()
3. 然后键入 Ctrl+Shift+Enter。这是在 Excel 中输入数组公式的标准方法。

Excel 中的 native 函数也以这种方式返回数组，例如 =LINEST()。

当然，以范围作为输入的函数不需要任何特殊的方式来输入它们 - 只有输出数组的函数需要用户做一些特殊的事情。