使用ICustomFunction功能

创建和评估用户定义的函数

本文演示了使用ICustomFunction接口实现自定义函数,并在电子表格中使用它获取结果。我们将按名称MyFunc定义一个自定义函数,其接受以下参数。

  • 第1个参数指代单个单元格
  • 第2个参数指代一系列的单元格

自定义函数将添加指定为第2个参数的单元格范围中的所有值,并将结果除以第1个参数中的值。

这里是我们如何实现CalculateCustomFunction方法的方式。

以下是如何在电子表格中使用新定义的函数

概述

Aspose.Cells的API在对应参数为引用或其计算结果为引用时,将ReferredArea对象放入"paramsList"中。如果您需要引用本身,可以直接使用ReferredArea。如果需要获取与公式位置对应的引用中单元格的值,可以使用ReferredArea.GetValue(rowOffset, int colOffset)方法。如果需要整个区域的单元格值数组,则可以使用ReferredArea.GetValues方法。

由于Aspose.Cells API在"paramsList"中提供了ReferredArea,因此"contextObjects"中的ReferredAreaCollection将不再需要(在旧版本中,它并不总是能够给出与自定义函数参数一一对应的映射),因此它已从"contextObjects"中移除。

 public object CalculateCustomFunction(string functionName, ArrayList paramsList, ArrayList contextObjects)

{

    ...

    object o = paramsList[i];

    if(o is ReferredArea) //fetch data from reference

    {

        ReferredArea ra = (ReferredArea)o;

        if(ra.IsArea)

        {

            o = ra.GetValues();

        }

        else

        {

            o = ra.GetValue(0, 0);

        }

    }

    if (o is Array)

    {

        ...

    }

    else if...

    ...

}