Excel.Interfaces.RangeCollectionLoadOptions interface

Пакет:
excel

Комментарии

Набор API: ExcelApi 1.9

Используется

Свойства

$all

Указание $all параметров загрузки загружает все скалярные свойства (такие как ), но не навигационные свойства (такие какRange.addressRange.format.fill.color ).
address

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает ссылку на диапазон в стиле А1. Значение адреса содержит ссылку на лист (например, "Лист1! A1:B4").
addressLocal

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет ссылку на диапазон для указанного диапазона на языке пользователя.
cellCount

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Указывает количество ячеек в диапазоне. Этот API возвращает значение -1, если количество ячеек превышает 2^31-1 (2,147,483,647).
columnCount

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Указывает общее количество столбцов в диапазоне.
columnHidden

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает, скрыты ли все столбцы в текущем диапазоне. Значение — true это когда все столбцы в диапазоне скрыты. Значение — это false если ни один столбец в диапазоне не скрыт. Значение указывает, null когда некоторые столбцы в диапазоне скрыты, а другие столбцы в том же диапазоне не скрыты.
columnIndex

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Указывает номер столбца первой ячейки в диапазоне. Используется нулевой индекс.
control

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Доступ к элементу управления ячейкой, применяемому к данному диапазону. Если диапазон содержит несколько элементов управления ячейками, возвращается EmptyCellControl.
dataValidation

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Возвращает объект проверки данных.
format

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Возвращает объект формата, инкапсулирующий шрифт, заливку, границы, выравнивание и другие свойства диапазона.
formulaArray

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Определяет формулу массива для диапазона. Если указанный диапазон не содержит формулу массива, это свойство возвращает null.
formulas

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет формулу в формате A1. Если ячейка не содержит формулы, возвращается ее значение.
formulasLocal

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет формулу в формате A1 на языке пользователя и языковом стандарте форматирования чисел. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке. Если ячейка не содержит формулы, возвращается ее значение.
formulasR1C1

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Представляет формулу в стиле R1C1. Если ячейка не содержит формулы, возвращается ее значение.
hasSpill

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает, все ли ячейки имеют границу переноса. Возвращает true , если все ячейки имеют границу переноса или false не имеют границы переноса. Возвращает null наличие, если в диапазоне есть ячейки с границами переноса и без них.
height

Для КАЖДОГО элемента коллекции: Возвращает расстояние в точках при масштабе 100 % от верхнего края диапазона до нижнего края диапазона.
hidden

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает, все ли ячейки в текущем диапазоне скрыты. Значение указывает, true когда все ячейки в диапазоне скрыты. Значение — false если ячейки в диапазоне не скрыты. Значение указывает, null когда некоторые ячейки в диапазоне скрыты, а другие ячейки в том же диапазоне не скрыты.
hyperlink

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет гиперссылку на текущий диапазон.
isEntireColumn

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет, является ли текущий диапазон целым столбцом.
isEntireRow

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет, является ли текущий диапазон целой строкой.
left

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Возвращает расстояние в точках при масштабе 100 % от левого края листа до левого края диапазона.
linkedDataTypeState

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет состояние типа данных каждой ячейки.
numberFormat

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о числовом форматировании в Excel см. в статье Коды числовых форматов.
numberFormatCategories

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Представляет формат каждой ячейки по категориям чисел.
numberFormatLocal

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет код числового формата Excel для заданного диапазона в зависимости от языковых настроек пользователя. Excel не выполняет приведение языка или формата при получении или настройке numberFormatLocal свойства. В любом возвращаемом тексте используются строки локального форматирования с учетом языка, указанного в параметрах системы.
rowCount

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Возвращает общее количество строк в диапазоне.
rowHidden

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает, все ли строки в текущем диапазоне скрыты. Значение — true это когда все строки диапазона скрыты. Значение — false это если строки в диапазоне не скрыты. Значение указывает, null когда некоторые строки в диапазоне скрыты, а другие строки в этом же диапазоне не скрыты.
rowIndex

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс.
savedAsArray

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет, все ли ячейки будут сохранены в формулу массива. Возвращает true результат, если все ячейки будут сохранены как формула массива или false не все ячейки будут сохранены как формула массива. Возвращает null , если некоторые ячейки будут сохранены как формула массива, а другие — нет.
style

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Представляет стиль текущего диапазона. Если стили ячеек не согласованы, null будет возвращен. Для пользовательских стилей возвращается имя стиля. Для встроенных стилей будет возвращена строка, представляющая значение в перечислении BuiltInStyle .
text

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Замена знака номера (#), которая происходит в пользовательском интерфейсе Excel, не влияет на текстовое значение, возвращаемое API.
top

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Возвращает расстояние в точках при масштабе 100 % от верхнего края листа до верхнего края диапазона.
values

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.
valuesAsJson

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJson поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту en-US. Чтобы получить данные в языковом стандарте отображения, заданном пользователем, используйте Range.valuesAsJsonLocal.
valuesAsJsonLocal

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJsonLocal поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту отображения, выбранному пользователем. Для получения данных, не зависящих от языкового стандарта, используйте Range.valuesAsJson.
valueTypes

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Указывает тип данных в каждой ячейке.
width

Для КАЖДОГО элемента коллекции: Возвращает расстояние в точках при масштабе 100 % от левого края диапазона до правого края диапазона.
worksheet

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Лист, содержащий текущий диапазон.

Сведения о свойстве

$all

Указание $all параметров загрузки загружает все скалярные свойства (такие как ), но не навигационные свойства (такие какRange.addressRange.format.fill.color ).

$all?: boolean;

Значение свойства

boolean

address

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает ссылку на диапазон в стиле А1. Значение адреса содержит ссылку на лист (например, "Лист1! A1:B4").

address?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

addressLocal

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет ссылку на диапазон для указанного диапазона на языке пользователя.

addressLocal?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

cellCount

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Указывает количество ячеек в диапазоне. Этот API возвращает значение -1, если количество ячеек превышает 2^31-1 (2,147,483,647).

cellCount?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

columnCount

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Указывает общее количество столбцов в диапазоне.

columnCount?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

columnHidden

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает, скрыты ли все столбцы в текущем диапазоне. Значение — true это когда все столбцы в диапазоне скрыты. Значение — это false если ни один столбец в диапазоне не скрыт. Значение указывает, null когда некоторые столбцы в диапазоне скрыты, а другие столбцы в том же диапазоне не скрыты.

columnHidden?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.2

columnIndex

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Указывает номер столбца первой ячейки в диапазоне. Используется нулевой индекс.

columnIndex?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

control

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Доступ к элементу управления ячейкой, применяемому к данному диапазону. Если диапазон содержит несколько элементов управления ячейками, возвращается EmptyCellControl.

control?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.18

dataValidation

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Возвращает объект проверки данных.

dataValidation?: Excel.Interfaces.DataValidationLoadOptions;

Значение свойства

Excel.Interfaces.DataValidationLoadOptions

Комментарии

Набор API: ExcelApi 1.9

format

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Возвращает объект формата, инкапсулирующий шрифт, заливку, границы, выравнивание и другие свойства диапазона.

format?: Excel.Interfaces.RangeFormatLoadOptions;

Значение свойства

Excel.Interfaces.RangeFormatLoadOptions

Комментарии

Набор API: ExcelApi 1.9

formulaArray

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Определяет формулу массива для диапазона. Если указанный диапазон не содержит формулу массива, это свойство возвращает null.

formulaArray?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApiDesktop 1.1

formulas

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет формулу в формате A1. Если ячейка не содержит формулы, возвращается ее значение.

formulas?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

formulasLocal

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет формулу в формате A1 на языке пользователя и языковом стандарте форматирования чисел. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке. Если ячейка не содержит формулы, возвращается ее значение.

formulasLocal?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

formulasR1C1

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Представляет формулу в стиле R1C1. Если ячейка не содержит формулы, возвращается ее значение.

formulasR1C1?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.2

hasSpill

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает, все ли ячейки имеют границу переноса. Возвращает true , если все ячейки имеют границу переноса или false не имеют границы переноса. Возвращает null наличие, если в диапазоне есть ячейки с границами переноса и без них.

hasSpill?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.12

height

Для КАЖДОГО элемента коллекции: Возвращает расстояние в точках при масштабе 100 % от верхнего края диапазона до нижнего края диапазона.

height?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.10

hidden

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает, все ли ячейки в текущем диапазоне скрыты. Значение указывает, true когда все ячейки в диапазоне скрыты. Значение — false если ячейки в диапазоне не скрыты. Значение указывает, null когда некоторые ячейки в диапазоне скрыты, а другие ячейки в том же диапазоне не скрыты.

hidden?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.2

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет гиперссылку на текущий диапазон.

hyperlink?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.7

isEntireColumn

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет, является ли текущий диапазон целым столбцом.

isEntireColumn?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.7

isEntireRow

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет, является ли текущий диапазон целой строкой.

isEntireRow?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.7

left

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Возвращает расстояние в точках при масштабе 100 % от левого края листа до левого края диапазона.

left?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.10

linkedDataTypeState

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет состояние типа данных каждой ячейки.

linkedDataTypeState?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.9

numberFormat

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет код числового формата Excel для заданного диапазона. Дополнительные сведения о числовом форматировании в Excel см. в статье Коды числовых форматов.

numberFormat?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

numberFormatCategories

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Представляет формат каждой ячейки по категориям чисел.

numberFormatCategories?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.12

numberFormatLocal

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет код числового формата Excel для заданного диапазона в зависимости от языковых настроек пользователя. Excel не выполняет приведение языка или формата при получении или настройке numberFormatLocal свойства. В любом возвращаемом тексте используются строки локального форматирования с учетом языка, указанного в параметрах системы.

numberFormatLocal?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.7

rowCount

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Возвращает общее количество строк в диапазоне.

rowCount?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

rowHidden

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Указывает, все ли строки в текущем диапазоне скрыты. Значение — true это когда все строки диапазона скрыты. Значение — false это если строки в диапазоне не скрыты. Значение указывает, null когда некоторые строки в диапазоне скрыты, а другие строки в этом же диапазоне не скрыты.

rowHidden?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.2

rowIndex

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс.

rowIndex?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

savedAsArray

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет, все ли ячейки будут сохранены в формулу массива. Возвращает true результат, если все ячейки будут сохранены как формула массива или false не все ячейки будут сохранены как формула массива. Возвращает null , если некоторые ячейки будут сохранены как формула массива, а другие — нет.

savedAsArray?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.12

style

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Представляет стиль текущего диапазона. Если стили ячеек не согласованы, null будет возвращен. Для пользовательских стилей возвращается имя стиля. Для встроенных стилей будет возвращена строка, представляющая значение в перечислении BuiltInStyle .

style?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.7

text

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Замена знака номера (#), которая происходит в пользовательском интерфейсе Excel, не влияет на текстовое значение, возвращаемое API.

text?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

top

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Возвращает расстояние в точках при масштабе 100 % от верхнего края листа до верхнего края диапазона.

top?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.10

values

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.

values?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

valuesAsJson

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJson поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту en-US. Чтобы получить данные в языковом стандарте отображения, заданном пользователем, используйте Range.valuesAsJsonLocal.

valuesAsJson?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.16

valuesAsJsonLocal

Для КАЖДОГО ЭЛЕМЕНТА в коллекции: JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJsonLocal поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту отображения, выбранному пользователем. Для получения данных, не зависящих от языкового стандарта, используйте Range.valuesAsJson.

valuesAsJsonLocal?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.16

valueTypes

Для КАЖДОГО ЭЛЕМЕНТА в наборе: Указывает тип данных в каждой ячейке.

valueTypes?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.1

width

Для КАЖДОГО элемента коллекции: Возвращает расстояние в точках при масштабе 100 % от левого края диапазона до правого края диапазона.

width?: boolean;

Значение свойства

boolean

Комментарии

Набор API: ExcelApi 1.10

worksheet

Для КАЖДОГО ЭЛЕМЕНТА коллекции: Лист, содержащий текущий диапазон.

worksheet?: Excel.Interfaces.WorksheetLoadOptions;

Значение свойства

Excel.Interfaces.WorksheetLoadOptions

Комментарии

Набор API: ExcelApi 1.9