Skip to content
v3.3.0

NamedExpressions

SHEET_FOR_WORKBOOK_EXPRESSIONS: number = -1

Defined in src/NamedExpressions.ts:127

addNamedExpression(expressionName: string, sheetId?: undefined | number, options?: NamedExpressionOptions): InternalNamedExpression

Defined in src/NamedExpressions.ts:189

Parameters:

NameType
expressionNamestring
sheetId?undefined | number
options?NamedExpressionOptions

Returns: InternalNamedExpression


getAllNamedExpressions(): object[]

Defined in src/NamedExpressions.ts:251

Returns: object[]


getAllNamedExpressionsForScope(scope?: undefined | number): InternalNamedExpression[]

Defined in src/NamedExpressions.ts:273

Parameters:

NameType
scope?undefined | number

Returns: InternalNamedExpression[]


getAllNamedExpressionsNames(): string[]

Defined in src/NamedExpressions.ts:247

Returns: string[]


getAllNamedExpressionsNamesInScope(sheetId?: undefined | number): string[]

Defined in src/NamedExpressions.ts:243

Parameters:

NameType
sheetId?undefined | number

Returns: string[]


isExpressionInScope(expressionName: string, sheetId: number): boolean

Defined in src/NamedExpressions.ts:162

Parameters:

NameType
expressionNamestring
sheetIdnumber

Returns: boolean


isNameAvailable(expressionName: string, sheetId?: undefined | number): boolean

Defined in src/NamedExpressions.ts:133

Parameters:

NameType
expressionNamestring
sheetId?undefined | number

Returns: boolean


isNameValid(expressionName: string): boolean

Defined in src/NamedExpressions.ts:177

Checks the validity of a named-expression’s name.

The name:

  • Must start with a Unicode letter or with an underscore (_).
  • Can contain only Unicode letters, numbers, underscores, and periods (.).
  • Can’t be the same as any possible reference in the A1 notation ([A-Za-z]+[0-9]+).
  • Can’t be the same as any possible reference in the R1C1 notation ([rR][0-9]*[cC][0-9]*).

The naming rules follow the OpenDocument standard.

Parameters:

NameType
expressionNamestring

Returns: boolean


namedExpressionForScope(expressionName: string, sheetId?: undefined | number): MaybeInternalNamedExpression

Defined in src/NamedExpressions.ts:150

Parameters:

NameType
expressionNamestring
sheetId?undefined | number

Returns: MaybeInternalNamedExpression


namedExpressionInAddress(row: number): MaybeInternalNamedExpression

Defined in src/NamedExpressions.ts:141

Parameters:

NameType
rownumber

Returns: MaybeInternalNamedExpression


namedExpressionOrPlaceholder(expressionName: string, sheetId: number): InternalNamedExpression

Defined in src/NamedExpressions.ts:212

Parameters:

NameType
expressionNamestring
sheetIdnumber

Returns: InternalNamedExpression


nearestNamedExpression(expressionName: string, sheetId: number): MaybeInternalNamedExpression

Defined in src/NamedExpressions.ts:158

Parameters:

NameType
expressionNamestring
sheetIdnumber

Returns: MaybeInternalNamedExpression


remove(expressionName: string, sheetId?: undefined | number): void

Defined in src/NamedExpressions.ts:225

Parameters:

NameType
expressionNamestring
sheetId?undefined | number

Returns: void


restoreNamedExpression(namedExpression: InternalNamedExpression, sheetId?: undefined | number): InternalNamedExpression

Defined in src/NamedExpressions.ts:204

Parameters:

NameType
namedExpressionInternalNamedExpression
sheetId?undefined | number

Returns: InternalNamedExpression


workbookNamedExpressionOrPlaceholder(expressionName: string): InternalNamedExpression

Defined in src/NamedExpressions.ts:216

Parameters:

NameType
expressionNamestring

Returns: InternalNamedExpression