Excel.Interfaces.RangeData interface
Интерфейс, описывающий данные, возвращаемые вызовом range.toJSON().
Свойства
| address | Указывает ссылку на диапазон в стиле А1. Значение адреса содержит ссылку на лист (например, "Лист1! A1:B4"). |
| address |
Представляет ссылку на диапазон для указанного диапазона на языке пользователя. |
| cell |
Указывает количество ячеек в диапазоне. Этот API возвращает значение -1, если количество ячеек превышает 2^31-1 (2,147,483,647). |
| column |
Указывает общее количество столбцов в диапазоне. |
| column |
Указывает, все ли столбцы в текущем диапазоне скрыты. Значение — |
| column |
Указывает номер столбца первой ячейки диапазона. Используется нулевой индекс. |
| conditional |
Коллекция |
| control | Доступ к элементу управления ячейкой, применяемому к данному диапазону. Если диапазон содержит несколько элементов управления ячейками, возвращается |
| data |
Возвращает объект проверки данных. |
| format | Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона. |
| formula |
Определяет формулу массива диапазона. Если указанный диапазон не содержит формулу массива, это свойство возвращает |
| formulas | Представляет формулу в формате A1. Если ячейка не содержит формулы, возвращается ее значение. |
| formulas |
Представляет формулу в нотации стиля A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке. Если ячейка не содержит формулы, возвращается ее значение. |
| formulasR1C1 | Представляет формулу в формате R1C1. Если ячейка не содержит формулы, возвращается ее значение. |
| has |
Указывает, есть ли во всех ячейках граница переноса. Возвращает |
| height | Возвращает расстояние в точках для масштаба 100 % от верхнего края диапазона до нижнего края диапазона. |
| hidden | Указывает, все ли ячейки в текущем диапазоне скрыты. Значение указывает, |
| hyperlink | Представляет гиперссылку на текущий диапазон. |
| is |
Указывает, является ли текущий диапазон целым столбцом. |
| is |
Указывает, является ли текущий диапазон целой строкой. |
| left | Возвращает расстояние в точках при масштабе 100 % от левого края листа до левого края диапазона. |
| linked |
Представляет состояние типа данных каждой ячейки. |
| number |
Представляет числовой код формата Excel для заданного диапазона. Дополнительные сведения о числовом форматировании в Excel см. в статье Коды числовых форматов. |
| number |
Представляет числовой формат каждой ячейки. |
| number |
Представляет код числового формата Excel для заданного диапазона в соответствии с языковыми настройками пользователя. Excel не выполняет приведение языка или формата при получении или настройке |
| row |
Возвращает общее количество строк в диапазоне. |
| row |
Указывает, все ли строки в текущем диапазоне скрыты. Значение — |
| row |
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс. |
| saved |
Представляет, все ли ячейки будут сохранены в формулу массива. Возвращает |
| style | Представляет стиль текущего диапазона. Если стили ячеек не согласованы, |
| text | Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Замена знака номера (#), которая происходит в пользовательском интерфейсе Excel, не влияет на текстовое значение, возвращаемое API. |
| top | Возвращает расстояние в точках от верхнего края листа до верхнего края диапазона при масштабе 100 %. |
| values | Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу. |
| values |
JSON-представление значений в ячейках в этом диапазоне. В отличие от , |
| values |
JSON-представление значений в ячейках в этом диапазоне. В отличие от , |
| value |
Определяет тип данных в каждой ячейке. |
| width | Возвращает расстояние в точках для масштаба 100 % от левого края диапазона до правого края диапазона. |
Сведения о свойстве
address
Указывает ссылку на диапазон в стиле А1. Значение адреса содержит ссылку на лист (например, "Лист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
Комментарии
conditionalFormats
Коллекция ConditionalFormats этих элементов пересекает диапазон.
conditionalFormats?: Excel.Interfaces.ConditionalFormatData[];Значение свойства
Комментарии
control
Доступ к элементу управления ячейкой, применяемому к данному диапазону. Если диапазон содержит несколько элементов управления ячейками, возвращается EmptyCellControl.
control?: CellControl;Значение свойства
Комментарии
dataValidation
Возвращает объект проверки данных.
dataValidation?: Excel.Interfaces.DataValidationData;Значение свойства
Комментарии
format
Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона.
format?: Excel.Interfaces.RangeFormatData;Значение свойства
Комментарии
formulaArray
Определяет формулу массива диапазона. Если указанный диапазон не содержит формулу массива, это свойство возвращает null.
formulaArray?: string;Значение свойства
string
Комментарии
formulas
Представляет формулу в формате A1. Если ячейка не содержит формулы, возвращается ее значение.
formulas?: any[][];Значение свойства
any[][]
Комментарии
formulasLocal
Представляет формулу в нотации стиля A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке. Если ячейка не содержит формулы, возвращается ее значение.
formulasLocal?: any[][];Значение свойства
any[][]
Комментарии
formulasR1C1
Представляет формулу в формате R1C1. Если ячейка не содержит формулы, возвращается ее значение.
formulasR1C1?: any[][];Значение свойства
any[][]
Комментарии
hasSpill
Указывает, есть ли во всех ячейках граница переноса. Возвращает true , если все ячейки имеют границу переноса или false не имеют границы переноса. Возвращает null наличие, если в диапазоне есть ячейки с границами переноса и без них.
hasSpill?: boolean;Значение свойства
boolean
Комментарии
height
Возвращает расстояние в точках для масштаба 100 % от верхнего края диапазона до нижнего края диапазона.
height?: number;Значение свойства
number
Комментарии
hidden
Указывает, все ли ячейки в текущем диапазоне скрыты. Значение указывает, true когда все ячейки в диапазоне скрыты. Значение — false если ячейки в диапазоне не скрыты. Значение указывает, null когда некоторые ячейки в диапазоне скрыты, а другие ячейки в том же диапазоне не скрыты.
hidden?: boolean;Значение свойства
boolean
Комментарии
hyperlink
Представляет гиперссылку на текущий диапазон.
hyperlink?: Excel.RangeHyperlink;Значение свойства
Комментарии
isEntireColumn
Указывает, является ли текущий диапазон целым столбцом.
isEntireColumn?: boolean;Значение свойства
boolean
Комментарии
isEntireRow
Указывает, является ли текущий диапазон целой строкой.
isEntireRow?: boolean;Значение свойства
boolean
Комментарии
left
Возвращает расстояние в точках при масштабе 100 % от левого края листа до левого края диапазона.
left?: number;Значение свойства
number
Комментарии
linkedDataTypeState
Представляет состояние типа данных каждой ячейки.
linkedDataTypeState?: Excel.LinkedDataTypeState[][];Значение свойства
Комментарии
numberFormat
Представляет числовой код формата Excel для заданного диапазона. Дополнительные сведения о числовом форматировании в Excel см. в статье Коды числовых форматов.
numberFormat?: any[][];Значение свойства
any[][]
Комментарии
numberFormatCategories
Представляет числовой формат каждой ячейки.
numberFormatCategories?: Excel.NumberFormatCategory[][];Значение свойства
Комментарии
numberFormatLocal
Представляет код числового формата Excel для заданного диапазона в соответствии с языковыми настройками пользователя. Excel не выполняет приведение языка или формата при получении или настройке numberFormatLocal свойства. В любом возвращаемом тексте используются строки локального форматирования с учетом языка, указанного в параметрах системы.
numberFormatLocal?: any[][];Значение свойства
any[][]
Комментарии
rowCount
Возвращает общее количество строк в диапазоне.
rowCount?: number;Значение свойства
number
Комментарии
rowHidden
Указывает, все ли строки в текущем диапазоне скрыты. Значение — true это когда все строки диапазона скрыты. Значение — false это если строки в диапазоне не скрыты. Значение указывает, null когда некоторые строки в диапазоне скрыты, а другие строки в этом же диапазоне не скрыты.
rowHidden?: boolean;Значение свойства
boolean
Комментарии
rowIndex
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс.
rowIndex?: number;Значение свойства
number
Комментарии
savedAsArray
Представляет, все ли ячейки будут сохранены в формулу массива. Возвращает true результат, если все ячейки будут сохранены как формула массива или false не все ячейки будут сохранены как формула массива. Возвращает null , если некоторые ячейки будут сохранены как формула массива, а другие — нет.
savedAsArray?: boolean;Значение свойства
boolean
Комментарии
style
Представляет стиль текущего диапазона. Если стили ячеек не согласованы, null будет возвращен. Для пользовательских стилей возвращается имя стиля. Для встроенных стилей будет возвращена строка, представляющая значение в перечислении BuiltInStyle .
style?: string;Значение свойства
string
Комментарии
text
Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Замена знака номера (#), которая происходит в пользовательском интерфейсе Excel, не влияет на текстовое значение, возвращаемое API.
text?: string[][];Значение свойства
string[][]
Комментарии
top
Возвращает расстояние в точках от верхнего края листа до верхнего края диапазона при масштабе 100 %.
top?: number;Значение свойства
number
Комментарии
values
Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.
values?: any[][];Значение свойства
any[][]
Комментарии
valuesAsJson
JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJson поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту en-US. Чтобы получить данные в языковом стандарте отображения, заданном пользователем, используйте Range.valuesAsJsonLocal.
valuesAsJson?: CellValue[][];Значение свойства
Excel.CellValue[][]
Комментарии
valuesAsJsonLocal
JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJsonLocal поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту отображения, выбранному пользователем. Для получения данных, не зависящих от языкового стандарта, используйте Range.valuesAsJson.
valuesAsJsonLocal?: CellValue[][];Значение свойства
Excel.CellValue[][]
Комментарии
valueTypes
Определяет тип данных в каждой ячейке.
valueTypes?: Excel.RangeValueType[][];Значение свойства
Комментарии
width
Возвращает расстояние в точках для масштаба 100 % от левого края диапазона до правого края диапазона.
width?: number;Значение свойства
number