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 |
Представляет, если все столбцы в текущем диапазоне скрыты. Значение — это |
column |
Задает номер столбца первой ячейки в диапазоне. Используется нулевой индекс. |
format | Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона. |
formulas | Представляет формулу в формате A1. Если в ячейке нет формулы, возвращается ее значение. |
formulas |
Представляет формулу в нотации стиля A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке. Если в ячейке нет формулы, возвращается ее значение. |
formulasR1C1 | Представляет формулу в формате R1C1. Если в ячейке нет формулы, возвращается ее значение. |
hidden | Представляет, скрыты ли все ячейки в текущем диапазоне. Значение — это |
number |
Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о форматировании чисел в Excel см. в разделе Коды числового формата. |
row |
Возвращает общее количество строк в диапазоне. |
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
Комментарии
columnHidden
Представляет, если все столбцы в текущем диапазоне скрыты. Значение — это true
, когда все столбцы в диапазоне скрыты. Значение имеет значение, false
если столбцы в диапазоне не скрыты. Значением считается, null
когда некоторые столбцы в диапазоне скрыты, а другие столбцы в том же диапазоне не скрыты.
columnHidden?: boolean;
Значение свойства
boolean
Комментарии
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[][]
Комментарии
formulasR1C1
Представляет формулу в формате R1C1. Если в ячейке нет формулы, возвращается ее значение.
formulasR1C1?: any[][];
Значение свойства
any[][]
Комментарии
hidden
Представляет, скрыты ли все ячейки в текущем диапазоне. Значение — это true
, когда все ячейки в диапазоне скрыты. Значение — это значение false
, когда ячейки в диапазоне не скрыты. Значение — это null
, когда некоторые ячейки в диапазоне скрыты, а другие ячейки в том же диапазоне не скрыты.
hidden?: boolean;
Значение свойства
boolean
Комментарии
numberFormat
Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о форматировании чисел в Excel см. в разделе Коды числового формата.
numberFormat?: any[][];
Значение свойства
any[][]
Комментарии
rowCount
Возвращает общее количество строк в диапазоне.
rowCount?: number;
Значение свойства
number
Комментарии
rowHidden
Представляет, скрыты ли все строки в текущем диапазоне. Значение — это true
, когда все строки в диапазоне скрыты. Значение — это значение false
, когда строки в диапазоне не скрыты. Значением является, null
когда некоторые строки в диапазоне скрыты, а другие строки в том же диапазоне не скрыты.
rowHidden?: boolean;
Значение свойства
boolean
Комментарии
rowIndex
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс.
rowIndex?: number;
Значение свойства
number
Комментарии
text
Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Подстановка числового знака (#), выполняемая в пользовательском интерфейсе Excel, не повлияет на текстовое значение, возвращаемое API.
text?: string[][];
Значение свойства
string[][]
Комментарии
values
Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строковыми, числовыми или логическими. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.
values?: any[][];
Значение свойства
any[][]
Комментарии
valueTypes
Указывает тип данных в каждой ячейке.
valueTypes?: Excel.RangeValueType[][];
Значение свойства
Комментарии
Office Add-ins