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 | Представляет, скрыты ли все ячейки в текущем диапазоне. Значение — это |
hyperlink | Представляет гиперссылку для текущего диапазона. |
is |
Указывает, является ли текущий диапазон целым столбцом. |
is |
Указывает, является ли текущий диапазон целой строкой. |
number |
Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о форматировании чисел в Excel см. в разделе Коды числового формата. |
number |
Представляет код числового формата Excel для заданного диапазона на основе языковых параметров пользователя. Excel не выполняет приведение языка или формата при получении или задании |
row |
Возвращает общее количество строк в диапазоне. |
row |
Представляет, скрыты ли все строки в текущем диапазоне. Значение — это |
row |
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс. |
style | Представляет стиль текущего диапазона. Если стили ячеек несогласованны, |
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
Комментарии
hyperlink
Представляет гиперссылку для текущего диапазона.
hyperlink?: boolean;
Значение свойства
boolean
Комментарии
isEntireColumn
Указывает, является ли текущий диапазон целым столбцом.
isEntireColumn?: boolean;
Значение свойства
boolean
Комментарии
isEntireRow
Указывает, является ли текущий диапазон целой строкой.
isEntireRow?: boolean;
Значение свойства
boolean
Комментарии
numberFormat
Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о форматировании чисел в Excel см. в разделе Коды числового формата.
numberFormat?: boolean;
Значение свойства
boolean
Комментарии
numberFormatLocal
Представляет код числового формата Excel для заданного диапазона на основе языковых параметров пользователя. Excel не выполняет приведение языка или формата при получении или задании numberFormatLocal
свойства. Любой возвращаемый текст использует строки в локальном формате на основе языка, указанного в параметрах системы.
numberFormatLocal?: boolean;
Значение свойства
boolean
Комментарии
rowCount
Возвращает общее количество строк в диапазоне.
rowCount?: boolean;
Значение свойства
boolean
Комментарии
rowHidden
Представляет, скрыты ли все строки в текущем диапазоне. Значение — это true
, когда все строки в диапазоне скрыты. Значение — это значение false
, когда строки в диапазоне не скрыты. Значением является, null
когда некоторые строки в диапазоне скрыты, а другие строки в том же диапазоне не скрыты.
rowHidden?: boolean;
Значение свойства
boolean
Комментарии
rowIndex
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс.
rowIndex?: boolean;
Значение свойства
boolean
Комментарии
style
Представляет стиль текущего диапазона. Если стили ячеек несогласованны, null
возвращается. Для пользовательских стилей будет возвращено имя стиля. Для встроенных стилей возвращается строка, представляющая значение в перечислении BuiltInStyle
.
style?: 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