Excel.Interfaces.RangeData interface
Интерфейс, описывающий данные, возвращаемые путем вызова range.toJSON()
.
Свойства
address | Указывает ссылку на диапазон в стиле A1. Значение address содержит ссылку на лист (например, "Лист1! A1:B4"). |
address |
Представляет ссылку на диапазон для указанного диапазона на языке пользователя. |
cell |
Указывает количество ячеек в диапазоне. Этот API возвращает значение -1, если количество ячеек превышает 2^31-1 (2,147,483,647). |
column |
Задает общее количество столбцов в диапазоне. |
column |
Задает номер столбца первой ячейки в диапазоне. Используется нулевой индекс. |
format | Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона. |
formulas | Представляет формулу в формате A1. Если в ячейке нет формулы, возвращается ее значение. |
formulas |
Представляет формулу в нотации стиля A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке. Если в ячейке нет формулы, возвращается ее значение. |
number |
Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о форматировании чисел в Excel см. в разделе Коды числового формата. |
row |
Возвращает общее количество строк в диапазоне. |
row |
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс. |
text | Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Подстановка числового знака (#), выполняемая в пользовательском интерфейсе Excel, не повлияет на текстовое значение, возвращаемое API. |
values | Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строковыми, числовыми или логическими. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу. |
value |
Указывает тип данных в каждой ячейке. |
Сведения о свойстве
address
Указывает ссылку на диапазон в стиле A1. Значение address содержит ссылку на лист (например, "Лист1! A1:B4").
address?: string;
Значение свойства
string
Комментарии
addressLocal
Представляет ссылку на диапазон для указанного диапазона на языке пользователя.
addressLocal?: string;
Значение свойства
string
Комментарии
cellCount
Указывает количество ячеек в диапазоне. Этот API возвращает значение -1, если количество ячеек превышает 2^31-1 (2,147,483,647).
cellCount?: number;
Значение свойства
number
Комментарии
columnCount
Задает общее количество столбцов в диапазоне.
columnCount?: number;
Значение свойства
number
Комментарии
columnIndex
Задает номер столбца первой ячейки в диапазоне. Используется нулевой индекс.
columnIndex?: number;
Значение свойства
number
Комментарии
format
Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона.
format?: Excel.Interfaces.RangeFormatData;
Значение свойства
Комментарии
formulas
Представляет формулу в формате A1. Если в ячейке нет формулы, возвращается ее значение.
formulas?: any[][];
Значение свойства
any[][]
Комментарии
formulasLocal
Представляет формулу в нотации стиля A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке. Если в ячейке нет формулы, возвращается ее значение.
formulasLocal?: any[][];
Значение свойства
any[][]
Комментарии
numberFormat
Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о форматировании чисел в Excel см. в разделе Коды числового формата.
numberFormat?: any[][];
Значение свойства
any[][]
Комментарии
rowCount
Возвращает общее количество строк в диапазоне.
rowCount?: number;
Значение свойства
number
Комментарии
rowIndex
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс.
rowIndex?: number;
Значение свойства
number
Комментарии
text
Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Подстановка числового знака (#), выполняемая в пользовательском интерфейсе Excel, не повлияет на текстовое значение, возвращаемое API.
text?: string[][];
Значение свойства
string[][]
Комментарии
values
Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строковыми, числовыми или логическими. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.
values?: any[][];
Значение свойства
any[][]
Комментарии
valueTypes
Указывает тип данных в каждой ячейке.
valueTypes?: Excel.RangeValueType[][];
Значение свойства
Комментарии
Office Add-ins