FormulaParseOptions

FormulaParseOptions class

Represents options when parsing formula.

class FormulaParseOptions;

Constructors

NameDescription
constructor()Default Constructor.

Methods

MethodDescription
getLocaleDependent()Whether the formula is locale formatted. Default is false.
setLocaleDependent(boolean)Whether the formula is locale formatted. Default is false.
getR1C1Style()Whether the formula is R1C1 reference style. Default is false.
setR1C1Style(boolean)Whether the formula is R1C1 reference style. Default is false.
getCheckAddIn()Whether check addins in existing external links of current workbook for user defined function without external link. Default is true(if user defined function matches one addin in existing external links, then take it as the addin).
setCheckAddIn(boolean)Whether check addins in existing external links of current workbook for user defined function without external link. Default is true(if user defined function matches one addin in existing external links, then take it as the addin).
getParse()Whether parse given formula. Default is true. If it is false, then given formula string will be kept as it is for the cell until user call other methods to parse them or parsed formula data is required by other operations such as calculating formulas.
setParse(boolean)Whether parse given formula. Default is true. If it is false, then given formula string will be kept as it is for the cell until user call other methods to parse them or parsed formula data is required by other operations such as calculating formulas.
getCustomFunctionDefinition()Definition for parsing custom functions.
setCustomFunctionDefinition(CustomFunctionDefinition)Definition for parsing custom functions.

constructor()

Default Constructor.

constructor();

getLocaleDependent()

Whether the formula is locale formatted. Default is false.

getLocaleDependent() : boolean;

setLocaleDependent(boolean)

Whether the formula is locale formatted. Default is false.

setLocaleDependent(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getR1C1Style()

Whether the formula is R1C1 reference style. Default is false.

getR1C1Style() : boolean;

setR1C1Style(boolean)

Whether the formula is R1C1 reference style. Default is false.

setR1C1Style(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getCheckAddIn()

Whether check addins in existing external links of current workbook for user defined function without external link. Default is true(if user defined function matches one addin in existing external links, then take it as the addin).

getCheckAddIn() : boolean;

setCheckAddIn(boolean)

Whether check addins in existing external links of current workbook for user defined function without external link. Default is true(if user defined function matches one addin in existing external links, then take it as the addin).

setCheckAddIn(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getParse()

Whether parse given formula. Default is true. If it is false, then given formula string will be kept as it is for the cell until user call other methods to parse them or parsed formula data is required by other operations such as calculating formulas.

getParse() : boolean;

setParse(boolean)

Whether parse given formula. Default is true. If it is false, then given formula string will be kept as it is for the cell until user call other methods to parse them or parsed formula data is required by other operations such as calculating formulas.

setParse(value: boolean) : void;

Parameters:

ParameterTypeDescription
valuebooleanThe value to set.

getCustomFunctionDefinition()

Definition for parsing custom functions.

getCustomFunctionDefinition() : CustomFunctionDefinition;

Returns

CustomFunctionDefinition

Remarks

For some special requirements, such as when calculating custom function in user’s custom engine, some parameters of it need to be caculated in array mode, using this property can mark those parameters as array mode when parsing the formula. Otherwise user needs to update those custom functions later by Workbook.UpdateCustomFunctionDefinition(CustomFunctionDefinition) to get the same result.

setCustomFunctionDefinition(CustomFunctionDefinition)

Definition for parsing custom functions.

setCustomFunctionDefinition(value: CustomFunctionDefinition) : void;

Parameters:

ParameterTypeDescription
valueCustomFunctionDefinitionThe value to set.

Remarks

For some special requirements, such as when calculating custom function in user’s custom engine, some parameters of it need to be caculated in array mode, using this property can mark those parameters as array mode when parsing the formula. Otherwise user needs to update those custom functions later by Workbook.UpdateCustomFunctionDefinition(CustomFunctionDefinition) to get the same result.