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