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 |
Задает номер столбца первой ячейки в диапазоне. Используется нулевой индекс. |
data |
Возвращает объект проверки данных. |
format | Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона. |
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 %-го увеличения от левого края диапазона до правого края диапазона. |
worksheet | Лист, содержащий текущий диапазон. |
Сведения о свойстве
$all
Указание $all
для LoadOptions загружает все скалярные свойства (например,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
Комментарии
dataValidation
Возвращает объект проверки данных.
dataValidation?: Excel.Interfaces.DataValidationLoadOptions;
Значение свойства
Комментарии
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
Комментарии
hasSpill
Указывает, есть ли во всех ячейках граница переноса. Возвращает значение true
, если все ячейки имеют границу разлива или false
если у всех ячеек нет границы разлива. Возвращает, null
если в диапазоне имеются ячейки как с границами разлива, так и без них.
hasSpill?: boolean;
Значение свойства
boolean
Комментарии
height
Возвращает расстояние в точках для 100 %-го увеличения от верхнего края диапазона до нижнего края диапазона.
height?: boolean;
Значение свойства
boolean
Комментарии
hidden
Представляет, скрыты ли все ячейки в текущем диапазоне. Значение — это true
, когда все ячейки в диапазоне скрыты. Значение — это значение false
, когда ячейки в диапазоне не скрыты. Значение — это null
, когда некоторые ячейки в диапазоне скрыты, а другие ячейки в том же диапазоне не скрыты.
hidden?: boolean;
Значение свойства
boolean
Комментарии
hyperlink
Представляет гиперссылку для текущего диапазона.
hyperlink?: boolean;
Значение свойства
boolean
Комментарии
isEntireColumn
Указывает, является ли текущий диапазон целым столбцом.
isEntireColumn?: boolean;
Значение свойства
boolean
Комментарии
isEntireRow
Указывает, является ли текущий диапазон целой строкой.
isEntireRow?: boolean;
Значение свойства
boolean
Комментарии
left
Возвращает расстояние в точках для 100 % увеличения от левого края листа до левого края диапазона.
left?: boolean;
Значение свойства
boolean
Комментарии
linkedDataTypeState
Представляет состояние типа данных каждой ячейки.
linkedDataTypeState?: boolean;
Значение свойства
boolean
Комментарии
numberFormat
Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о форматировании чисел в Excel см. в разделе Коды числового формата.
numberFormat?: boolean;
Значение свойства
boolean
Комментарии
numberFormatCategories
Представляет категорию числового формата каждой ячейки.
numberFormatCategories?: boolean;
Значение свойства
boolean
Комментарии
numberFormatLocal
Представляет код числового формата Excel для заданного диапазона на основе языковых параметров пользователя. Excel не выполняет приведение языка или формата при получении или задании numberFormatLocal
свойства. Любой возвращаемый текст использует строки в локальном формате на основе языка, указанного в параметрах системы.
numberFormatLocal?: boolean;
Значение свойства
boolean
Комментарии
rowCount
Возвращает общее количество строк в диапазоне.
rowCount?: boolean;
Значение свойства
boolean
Комментарии
rowHidden
Представляет, скрыты ли все строки в текущем диапазоне. Значение — это true
, когда все строки в диапазоне скрыты. Значение — это значение false
, когда строки в диапазоне не скрыты. Значением является, null
когда некоторые строки в диапазоне скрыты, а другие строки в том же диапазоне не скрыты.
rowHidden?: boolean;
Значение свойства
boolean
Комментарии
rowIndex
Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс.
rowIndex?: boolean;
Значение свойства
boolean
Комментарии
savedAsArray
Представляет, будут ли все ячейки сохранены в виде формулы массива. Возвращает значение true
, если все ячейки будут сохранены в виде формулы массива или false
если все ячейки не будут сохранены в виде формулы массива. Возвращает значение null
, если некоторые ячейки будут сохранены в виде формулы массива, а некоторые — нет.
savedAsArray?: boolean;
Значение свойства
boolean
Комментарии
style
Представляет стиль текущего диапазона. Если стили ячеек несогласованны, null
возвращается. Для пользовательских стилей будет возвращено имя стиля. Для встроенных стилей возвращается строка, представляющая значение в перечислении BuiltInStyle
.
style?: boolean;
Значение свойства
boolean
Комментарии
text
Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Подстановка числового знака (#), выполняемая в пользовательском интерфейсе Excel, не повлияет на текстовое значение, возвращаемое API.
text?: boolean;
Значение свойства
boolean
Комментарии
top
Возвращает расстояние в точках для 100% увеличения от верхнего края листа до верхнего края диапазона.
top?: boolean;
Значение свойства
boolean
Комментарии
values
Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строковыми, числовыми или логическими. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.
values?: boolean;
Значение свойства
boolean
Комментарии
valuesAsJson
Представление значений в ячейках в этом диапазоне в формате JSON. В отличие от Range.values
поддерживает Range.valuesAsJson
все типы данных, которые могут находиться в ячейке. Примеры включают форматированные числовые значения и веб-изображения, а также стандартные логические, числовые и строковые значения. Данные, возвращаемые из этого API, всегда соответствуют языковому стандарту en-US. Чтобы получить данные в языковом стандарте отображения пользователя, используйте .Range.valuesAsJsonLocal
valuesAsJson?: boolean;
Значение свойства
boolean
Комментарии
valuesAsJsonLocal
Представление значений в ячейках в этом диапазоне в формате JSON. В отличие от Range.values
поддерживает Range.valuesAsJsonLocal
все типы данных, которые могут находиться в ячейке. Примеры включают форматированные числовые значения и веб-изображения, а также стандартные логические, числовые и строковые значения. Данные, возвращаемые из этого API, всегда соответствуют языковому стандарту отображения пользователя. Чтобы получить данные, не зависящие от языкового стандарта, используйте .Range.valuesAsJson
valuesAsJsonLocal?: boolean;
Значение свойства
boolean
Комментарии
valueTypes
Указывает тип данных в каждой ячейке.
valueTypes?: boolean;
Значение свойства
boolean
Комментарии
width
Возвращает расстояние в точках для 100 %-го увеличения от левого края диапазона до правого края диапазона.
width?: boolean;
Значение свойства
boolean
Комментарии
worksheet
Лист, содержащий текущий диапазон.
worksheet?: Excel.Interfaces.WorksheetLoadOptions;
Значение свойства
Комментарии
Office Add-ins