Excel.Interfaces.RangeLoadOptions interface
Диапазон представляет набор из одной или нескольких смежных ячеек, таких как ячейка, строка, столбец или блок ячеек. Чтобы узнать больше о том, как диапазоны используются в API, начните с ranges in the Excel JavaScript API.
Комментарии
Свойства
$all | Указание |
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 |
Указывает тип данных в каждой ячейке. |
worksheet | Лист, содержащий текущий диапазон. |
Сведения о свойстве
$all
Указание $all
для параметров загрузки загружает все скалярные свойства (например,Range.address
), но не свойства навигации (например, Range.format.fill.color
).
$all?: boolean;
Значение свойства
boolean
address
Указывает ссылку на диапазон в стиле A1. Значение address содержит ссылку на лист (например, "Лист1! A1:B4").
address?: boolean;
Значение свойства
boolean
Комментарии
addressLocal
Представляет ссылку на диапазон для указанного диапазона на языке пользователя.
addressLocal?: boolean;
Значение свойства
boolean
Комментарии
cellCount
Указывает количество ячеек в диапазоне. Этот API возвращает значение -1, если количество ячеек превышает 2^31-1 (2,147,483,647).
cellCount?: boolean;
Значение свойства
boolean
Комментарии
columnCount
Задает общее количество столбцов в диапазоне.
columnCount?: boolean;
Значение свойства
boolean
Комментарии
columnHidden
Представляет, если все столбцы в текущем диапазоне скрыты. Значение — это true
, когда все столбцы в диапазоне скрыты. Значение имеет значение, false
если столбцы в диапазоне не скрыты. Значением считается, null
когда некоторые столбцы в диапазоне скрыты, а другие столбцы в том же диапазоне не скрыты.
columnHidden?: boolean;
Значение свойства
boolean
Комментарии
columnIndex
Задает номер столбца первой ячейки в диапазоне. Используется нулевой индекс.
columnIndex?: boolean;
Значение свойства
boolean
Комментарии
format
Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона.
format?: Excel.Interfaces.RangeFormatLoadOptions;
Значение свойства
Комментарии
formulas
Представляет формулу в формате A1. Если в ячейке нет формулы, возвращается ее значение.
formulas?: boolean;
Значение свойства
boolean
Комментарии
formulasLocal
Представляет формулу в нотации стиля A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке. Если в ячейке нет формулы, возвращается ее значение.
formulasLocal?: boolean;
Значение свойства
boolean
Комментарии
formulasR1C1
Представляет формулу в формате R1C1. Если в ячейке нет формулы, возвращается ее значение.
formulasR1C1?: boolean;
Значение свойства
boolean
Комментарии
hidden
Представляет, скрыты ли все ячейки в текущем диапазоне. Значение — это true
, когда все ячейки в диапазоне скрыты. Значение — это значение false
, когда ячейки в диапазоне не скрыты. Значение — это null
, когда некоторые ячейки в диапазоне скрыты, а другие ячейки в том же диапазоне не скрыты.
hidden?: boolean;
Значение свойства
boolean
Комментарии
numberFormat
Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о форматировании чисел в Excel см. в разделе Коды числового формата.
numberFormat?: boolean;
Значение свойства
boolean
Комментарии
rowCount
Возвращает общее количество строк в диапазоне.
rowCount?: boolean;
Значение свойства
boolean
Комментарии
rowHidden
Представляет, скрыты ли все строки в текущем диапазоне. Значение — это true
, когда все строки в диапазоне скрыты. Значение — это значение false
, когда строки в диапазоне не скрыты. Значением является, null
когда некоторые строки в диапазоне скрыты, а другие строки в том же диапазоне не скрыты.
rowHidden?: boolean;
Значение свойства
boolean
Комментарии
rowIndex
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс.
rowIndex?: boolean;
Значение свойства
boolean
Комментарии
text
Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Подстановка числового знака (#), выполняемая в пользовательском интерфейсе Excel, не повлияет на текстовое значение, возвращаемое API.
text?: boolean;
Значение свойства
boolean
Комментарии
values
Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строковыми, числовыми или логическими. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.
values?: boolean;
Значение свойства
boolean
Комментарии
valueTypes
Указывает тип данных в каждой ячейке.
valueTypes?: boolean;
Значение свойства
boolean
Комментарии
worksheet
Лист, содержащий текущий диапазон.
worksheet?: Excel.Interfaces.WorksheetLoadOptions;
Значение свойства
Комментарии
Office Add-ins