Excel.ArrayCellValue interface

Pacote:
excel

Representa uma matriz 2D de valores de células.

Comentários

Conjunto de API: ExcelApi 1.16

Exemplos

const sheet = context.workbook.worksheets.getActiveWorksheet();

// This `EntityCellValue` contains an `ArrayCellValue` with two products and their prices.
const myEntity: Excel.EntityCellValue = {
    type: Excel.CellValueType.entity,
    text: "Product Catalog",
    properties: {
        items: {
            type: Excel.CellValueType.array, /* ArrayCellValue */
            elements: [[
                {
                    type: Excel.CellValueType.string,
                    basicValue: "Bicycle"
                },
                {
                    type: Excel.CellValueType.double,
                    basicValue: 300,
                    numberFormat: "$* #,##0.00",
                }
            ],
            [
                {
                    type: Excel.CellValueType.string,
                    basicValue: "Helmet"
                },
                {
                    type: Excel.CellValueType.double,
                    basicValue: 25,
                    numberFormat: "$* #,##0.00",
                }           
            ]],
            basicType: Excel.RangeValueType.error,
            basicValue: "#VALUE!"
        }
    },
    basicType: Excel.RangeValueType.error, // A read-only property. Used as a fallback in incompatible scenarios.
    basicValue: "#VALUE!" // A read-only property. Used as a fallback in incompatible scenarios.
};

sheet.getCell(0,0).valuesAsJson = [[myEntity]];

Propriedades

basicType

Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue

Representa o valor que seria devolvido por para Range.values uma célula com este valor. Quando acedido através de uma valuesAsJson propriedade, este valor de cadeia alinha-se com a região en-US. Quando acedido através de uma valuesAsJsonLocal propriedade, este valor de cadeia alinha-se com a região de apresentação do utilizador.
elements

Representa os elementos da matriz. Pode não conter diretamente um ArrayCellValue.
referencedValues

Representa os valores das células que são referenciados em ArrayCellValue.elements.
type

Representa o tipo deste valor de célula.

Detalhes da propriedade

basicType

Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.

basicType?: RangeValueType.error | "Error";

Valor da propriedade

error | "Error"

Comentários

Conjunto de API: ExcelApi 1.16

basicValue

Representa o valor que seria devolvido por para Range.values uma célula com este valor. Quando acedido através de uma valuesAsJson propriedade, este valor de cadeia alinha-se com a região en-US. Quando acedido através de uma valuesAsJsonLocal propriedade, este valor de cadeia alinha-se com a região de apresentação do utilizador.

basicValue?: "#VALUE!" | string;

Valor da propriedade

"#VALUE!" | string

Comentários

Conjunto de API: ExcelApi 1.16

elements

Representa os elementos da matriz. Pode não conter diretamente um ArrayCellValue.

elements: CellValue[][];

Valor da propriedade

Excel.CellValue[][]

Comentários

Conjunto de API: ExcelApi 1.16

referencedValues

Representa os valores das células que são referenciados em ArrayCellValue.elements.

referencedValues?: ReferencedValue[];

Valor da propriedade

Excel.ReferencedValue[]

Comentários

Conjunto de API: ExcelApi 1.16

type

Representa o tipo deste valor de célula.

type: CellValueType.array | ReferenceValueType.array | "Array";

Valor da propriedade

array | array | "Array"

Comentários

Conjunto de API: ExcelApi 1.16