Excel.ArrayCellValue interface

Пакет:

excel

Представляет двухмерный массив значений ячеек.

Комментарии

Набор API: ExcelApi 1.16

Примеры

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]];

Свойства

basicType	Представляет значение, возвращаемое для ячейки с этим значением Range.valueTypes .
basicValue	Представляет значение, возвращаемое для ячейки с этим значением Range.values . При доступе valuesAsJson через свойство это строковое значение выравнивается с языковым стандартом en-US. При доступе к свойству valuesAsJsonLocal это строковое значение выравнивается с языковым стандартом отображения пользователя.
elements	Представляет элементы массива. Может не содержать напрямую .ArrayCellValue
referencedValues	Представляет значения ячеек, на которые ссылается .ArrayCellValue.elements
type	Представляет тип этого значения ячейки.

Сведения о свойстве

basicType

Представляет значение, возвращаемое для ячейки с этим значением Range.valueTypes .

basicType?: RangeValueType.error | "Error";

Значение свойства

error | "Error"

Комментарии

Набор API: ExcelApi 1.16

basicValue

Представляет значение, возвращаемое для ячейки с этим значением Range.values . При доступе valuesAsJson через свойство это строковое значение выравнивается с языковым стандартом en-US. При доступе к свойству valuesAsJsonLocal это строковое значение выравнивается с языковым стандартом отображения пользователя.

basicValue?: "#VALUE!" | string;

Значение свойства

"#VALUE!" | string

Комментарии

Набор API: ExcelApi 1.16

elements

Представляет элементы массива. Может не содержать напрямую .ArrayCellValue

elements: CellValue[][];

Значение свойства

Excel.CellValue[][]

Комментарии

Набор API: ExcelApi 1.16

referencedValues

Представляет значения ячеек, на которые ссылается .ArrayCellValue.elements

referencedValues?: ReferencedValue[];

Значение свойства

Excel.ReferencedValue[]

Комментарии

Набор API: ExcelApi 1.16

type

Представляет тип этого значения ячейки.

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

Значение свойства

array | array | "Array"

Комментарии

Набор API: ExcelApi 1.16