Excel.Interfaces.RangeCollectionLoadOptions interface
Комментарии
Свойства
$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