公式属性

如果属性值需要依赖公式的计算结果动态变化，可以通过标注FormulaPropertyAttribute 的方式设置。

注意，标注FormulaPropertyAttribute的属性类型必须是 object。

    public class MyPluginCommand : Command
    {
        [FormulaProperty]
        public object MyProperty { get; set; }
    }

在设计器中效果如下：

为支持公式属性，命令对应的JavaScript类也需要对应的处理，可以通过evaluateFormula方法计算公式的值。

class MyPluginCommand extends Forguncy.Plugin.CommandBase{
    execute() {
        const formula = this.CommandParam.MyProperty;
        const result = this.evaluateFormula(formula);
        alert(result);
    }
}

Forguncy.Plugin.CommandFactory.registerCommand("MyPlugin.MyPluginCommand, MyPlugin", MyPluginCommand);

如果需要更细致的控制，可以通过FormulaPropertyAttribute的其他属性来控制。

1.提供备选列表。

1. 设置FormulaPropertyAttribute 的 RecommendedValues 属性，使用“|”分隔多个候选项。

2. 代码：

       public class MyPluginCommand : Command
       {
           [FormulaProperty(RecommendedValues = "学生|教师|工人")]
           public object MyProperty { get; set; }
       }

3. 效果如下：

   
   

2.支持输入多行文本。

1. 设置FormulaPropertyAttribute 的 AcceptsReturn 属性。

2. 代码：

       public class MyPluginCommand : Command
       {
           [FormulaProperty(AcceptsReturn = true)]
           public object MyProperty { get; set; }
       }

3. 效果如下：

   
   

3.限制仅选择单元格。

1. 设置FormulaPropertyAttribute 的 OnlySupportCell 属性。如果OnlySupportCell属性设置为True，用户只能给属性输入类似于 “=A1”这样的单元格引用。如果输入了类似“=A1+1”这样的表达式，会导致报错。

2. 代码如下：

       public class MyPluginCommand : Command
       {
           [FormulaProperty(OnlySupportCell = true)]
           public object MyProperty { get; set; }
       }

3. 效果如下：

   
   

4. 在JavaScript中，通过公式获取单元格对象。如果公式引用的是单一单元格，可以通过getCellLocation， getCellByLocation方法获取单元格实例并进行操作。

   class MyPluginCommand extends Forguncy.Plugin.CommandBase{
       execute() {
           const formula = this.CommandParam.MyProperty;
           const cellLoaction = this.getCellLocation(formula);
           const cell = Forguncy.Page.getCellByLocation(cellLoaction);
           cell.setValue("Test");
       }
   }
   
   Forguncy.Plugin.CommandFactory.registerCommand("MyPlugin.MyPluginCommand, MyPlugin", MyPluginCommand);