ig.excel.ArrayFormula

Represents an array formula for a group of cells.

Remarks

Array formulas are similar to regular formula in that they have the same grammar. However, array formulas must be set on a single region of cells only. When the array formula is applied to a region of cells, each cell's Formula property will be the array formula. The Value of each cell cannot be changed unless ArrayFormula.clearCellRange is called on the array formula or another value is applied to a region of cells which completely contains the array formula's region.

Because the array formula stores the region of the cells to which it is applied in the ArrayFormula.cellRange property, the array formula can only be applied to one region of cells.

Array formulas are created through Microsoft Excel by selecting a region of cells, entering a formula for that range, and pressing Ctrl+Shift+Enter. This causes the formula of each cell in the region to appear as follows: {=Formula}.

See the Microsoft Excel documentation for more information on array formulas.

Dependencies

jquery-1.4.4.js
infragistics.util.js
infragistics.ext_core.js
infragistics.ext_collections.js
infragistics.ext_collectionsExtended.js
infragistics.ext_io.js
infragistics.ext_text.js
infragistics.documents.core_core.js
infragistics.ext_ui.js
The current widget has no options.
The current widget has no events.
  • applyTo
    Inherited

    .applyTo( regions:ig.excel.WorksheetRegion[] );

    Applies the formula to all specified regions of cells.

    • regions
    • Type:ig.excel.WorksheetRegion[]
    • The regions of cells to apply the formula to.

    Exceptions

    Exception Description
    ig.ArgumentNullException regions is null.
    ig.ArgumentException regions has a length of 0.
    ig.ArgumentException Not all regions specified are from the same worksheet.
    ig.InvalidOperationException One or more regions specified contain array formulas or data tables which extend outside the region.

    Remarks

    This method, or one of the other ApplyTo overrides must be used to set the value of a cell to a formula.

    After this method returns, the WorksheetCell.formula of all cells in all specified regions will return the formula.

  • applyTo
    Inherited

    .applyTo( cell:ig.excel.WorksheetCell );

    Applies the formula to the specified cell.

    • cell
    • Type:ig.excel.WorksheetCell
    • The cell to apply the formula to.

    Exceptions

    Exception Description
    ig.ArgumentNullException cell is null.
    ig.InvalidOperationException cell is part of an array formula or data table which is not confined to just the cell.

    Remarks

    This method, or one of the other ApplyTo overrides must be used to set the value of a cell to a formula.

    After this method returns, the WorksheetCell.formula of the specified cell will return the formula.

  • applyTo
    Inherited

    .applyTo( region:ig.excel.WorksheetRegion );

    Applies the formula to the specified region of cells.

    • region
    • Type:ig.excel.WorksheetRegion
    • The region of cells to apply the formula to.

    Exceptions

    Exception Description
    ig.ArgumentNullException region is null.
    ig.InvalidOperationException region contains an array formula or data table which extends outside the region.

    Remarks

    This method, or one of the other ApplyTo overrides must be used to set the value of a cell to a formula.

    After this method returns, the WorksheetCell.formula of all cells in the specified region will return the formula.

  • cellRange

    .cellRange( );
    Return Type:
    ig.excel.WorksheetRegion
    Return Type Description:
    The cells to which the array formula is applied.

    Gets the cells to which the array formula is applied.

    Remarks

    If this is null, the formula has not yet been applied.

  • clearCellRange

    .clearCellRange( );

    Removes this array formula as the formula for the cells to which it was applied.

    Remarks

    After this method returns, the ArrayFormula.cellRange will be null.

  • equalsStatic
    Inherited

    .equalsStatic( formulaA:ig.excel.Formula, formulaB:ig.excel.Formula, cellReferenceMode:ig.excel.CellReferenceMode );
    Return Type:
    boolean
    Return Type Description:
    True if the formulas are both null or both equivalent; False otherwise.

    Determines whether two Formula instances are equal using the specified cell reference mode.

    • formulaA
    • Type:ig.excel.Formula
    • The first Formula to compare.
    • formulaB
    • Type:ig.excel.Formula
    • The second Formula to compare.
    • cellReferenceMode
    • Type:ig.excel.CellReferenceMode
    • The cell reference mode to use when comparing the two formulas.

    Remarks

    This essentially performs a case-insensitive string comparison, ignoring the white space in the formula.
  • parse

    .parse( value:string, cellReferenceMode:ig.excel.CellReferenceMode );
    Return Type:
    ig.excel.ArrayFormula
    Return Type Description:
    An ArrayFormula instance which represents the array formula value specified.

    Parses the specified formula value and returns the array formula which was created from it.

    • value
    • Type:string
    • The string which defines the array formula to parse.
    • cellReferenceMode
    • Type:ig.excel.CellReferenceMode
    • The mode used to interpret cell references in the array formula.

    Exceptions

    Exception Description
    ig.ArgumentNullException value is null or empty.
    ig.excel.InvalidEnumArgumentException cellReferenceMode is not defined in the CellReferenceMode enumeration.
    ig.excel.FormulaParseException value is not a valid formula.
  • parse

    .parse( value:string, cellReferenceMode:ig.excel.CellReferenceMode, fileFormat:ig.excel.WorkbookFormat );
    Return Type:
    ig.excel.ArrayFormula
    Return Type Description:
    An ArrayFormula instance which represents the array formula value specified.

    Parses the specified formula value and returns the array formula which was created from it.

    • value
    • Type:string
    • The string which defines the array formula to parse.
    • cellReferenceMode
    • Type:ig.excel.CellReferenceMode
    • The mode used to interpret cell references in the array formula.
    • fileFormat
    • Type:ig.excel.WorkbookFormat
    • The file format to use when parsing the array formula. This will be used to determine certain limits which are format dependant.

    Exceptions

    Exception Description
    ig.ArgumentNullException value is null or empty.
    ig.excel.InvalidEnumArgumentException cellReferenceMode is not defined in the CellReferenceMode enumeration.
    ig.excel.InvalidEnumArgumentException fileFormat is not defined in the WorkbookFormat enumeration.
    ig.excel.FormulaParseException value is not a valid formula.
  • parse

    .parse( value:string, cellReferenceMode:ig.excel.CellReferenceMode, fileFormat:ig.excel.WorkbookFormat, culture:string );
    Return Type:
    ig.excel.ArrayFormula
    Return Type Description:
    An ArrayFormula instance which represents the array formula value specified.

    Parses the specified formula value and returns the array formula which was created from it.

    • value
    • Type:string
    • The string which defines the array formula to parse.
    • cellReferenceMode
    • Type:ig.excel.CellReferenceMode
    • The mode used to interpret cell references in the array formula.
    • fileFormat
    • Type:ig.excel.WorkbookFormat
    • The file format to use when parsing the array formula. This will be used to determine certain limits which are format dependant.
    • culture
    • Type:string
    • The culture used to parse the formula.

    Exceptions

    Exception Description
    ig.ArgumentNullException value is null or empty.
    ig.excel.InvalidEnumArgumentException cellReferenceMode is not defined in the CellReferenceMode enumeration.
    ig.excel.InvalidEnumArgumentException fileFormat is not defined in the WorkbookFormat enumeration.
    ig.excel.FormulaParseException value is not a valid formula.
  • parse

    .parse( value:string, cellReferenceMode:ig.excel.CellReferenceMode, culture:string );
    Return Type:
    ig.excel.ArrayFormula
    Return Type Description:
    An ArrayFormula instance which represents the array formula value specified.

    Parses the specified formula value and returns the array formula which was created from it.

    • value
    • Type:string
    • The string which defines the array formula to parse.
    • cellReferenceMode
    • Type:ig.excel.CellReferenceMode
    • The mode used to interpret cell references in the array formula.
    • culture
    • Type:string
    • The culture used to parse the formula.

    Exceptions

    Exception Description
    ig.ArgumentNullException value is null or empty.
    ig.excel.InvalidEnumArgumentException cellReferenceMode is not defined in the CellReferenceMode enumeration.
    ig.excel.FormulaParseException value is not a valid formula.
  • toString
    Inherited

    .toString( );
    Return Type:
    string
    Return Type Description:
    The string representing the formula.

    Converts the formula to a string representation, similar to the string with which it was created. This uses the CellReferenceMode with which the formula was created to create cell reference strings.

  • toString
    Inherited

    .toString( cellReferenceMode:ig.excel.CellReferenceMode );
    Return Type:
    string
    Return Type Description:
    The string representing the formula.

    Converts the formula to a string representation, similar to the string with which it was created.

    • cellReferenceMode
    • Type:ig.excel.CellReferenceMode
    • The cell reference mode used to create cell reference strings.
  • toString
    Inherited

    .toString( cellReferenceMode:ig.excel.CellReferenceMode, culture:string );
    Return Type:
    string
    Return Type Description:
    The string representing the formula.

    Converts the formula to a string representation, similar to the string with which it was created.

    • cellReferenceMode
    • Type:ig.excel.CellReferenceMode
    • The cell reference mode used to create cell reference strings.
    • culture
    • Type:string
    • The culture used to generate the formula string.

Copyright © 1996 - 2024 Infragistics, Inc. All rights reserved.