Excel.Interfaces.RangeUpdateData interface

Интерфейс обновления данных об объекте Range для использования в range.set({ ... }).

Комментарии

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

Свойства

columnHidden

Указывает, все ли столбцы в текущем диапазоне скрыты. Значение — true это когда все столбцы в диапазоне скрыты. Значение — это false если ни один столбец в диапазоне не скрыт. Значение указывает, null когда некоторые столбцы в диапазоне скрыты, а другие столбцы в том же диапазоне не скрыты.

control

Доступ к элементу управления ячейкой, применяемому к данному диапазону. Если диапазон содержит несколько элементов управления ячейками, возвращается EmptyCellControl.

dataValidation

Возвращает объект проверки данных.

format

Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона.

formulaArray

Определяет формулу массива диапазона. Если указанный диапазон не содержит формулу массива, это свойство возвращает null.

formulas

Представляет формулу в формате A1. Если ячейка не содержит формулы, возвращается ее значение.

formulasLocal

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

formulasR1C1

Представляет формулу в формате R1C1. Если ячейка не содержит формулы, возвращается ее значение.

hyperlink

Представляет гиперссылку на текущий диапазон.

numberFormat

Представляет числовой код формата Excel для заданного диапазона. Дополнительные сведения о числовом форматировании в Excel см. в статье Коды числовых форматов.

numberFormatLocal

Представляет код числового формата Excel для заданного диапазона в соответствии с языковыми настройками пользователя. Excel не выполняет приведение языка или формата при получении или настройке numberFormatLocal свойства. В любом возвращаемом тексте используются строки локального форматирования с учетом языка, указанного в параметрах системы.

rowHidden

Указывает, все ли строки в текущем диапазоне скрыты. Значение — true это когда все строки диапазона скрыты. Значение — false это если строки в диапазоне не скрыты. Значение указывает, null когда некоторые строки в диапазоне скрыты, а другие строки в этом же диапазоне не скрыты.

style

Представляет стиль текущего диапазона. Если стили ячеек не согласованы, null будет возвращен. Для пользовательских стилей возвращается имя стиля. Для встроенных стилей будет возвращена строка, представляющая значение в перечислении BuiltInStyle .

values

Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.

valuesAsJson

JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJson поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту en-US. Чтобы получить данные в языковом стандарте отображения, заданном пользователем, используйте Range.valuesAsJsonLocal.

valuesAsJsonLocal

JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJsonLocal поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту отображения, выбранному пользователем. Для получения данных, не зависящих от языкового стандарта, используйте Range.valuesAsJson.

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

columnHidden

Указывает, все ли столбцы в текущем диапазоне скрыты. Значение — true это когда все столбцы в диапазоне скрыты. Значение — это false если ни один столбец в диапазоне не скрыт. Значение указывает, null когда некоторые столбцы в диапазоне скрыты, а другие столбцы в том же диапазоне не скрыты.

columnHidden?: boolean;

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

boolean

Комментарии

Набор API: ExcelApi 1.2

control

Доступ к элементу управления ячейкой, применяемому к данному диапазону. Если диапазон содержит несколько элементов управления ячейками, возвращается EmptyCellControl.

control?: CellControl;

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

Комментарии

Набор API: ExcelApi 1.18

dataValidation

Возвращает объект проверки данных.

dataValidation?: Excel.Interfaces.DataValidationUpdateData;

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

Комментарии

Набор API: ExcelApi 1.8

format

Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона.

format?: Excel.Interfaces.RangeFormatUpdateData;

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

Комментарии

Набор API: ExcelApi 1.1

formulaArray

Определяет формулу массива диапазона. Если указанный диапазон не содержит формулу массива, это свойство возвращает null.

formulaArray?: string;

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

string

Комментарии

Набор API: ExcelApiDesktop 1.1

formulas

Представляет формулу в формате A1. Если ячейка не содержит формулы, возвращается ее значение.

formulas?: any[][];

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

any[][]

Комментарии

Набор API: ExcelApi 1.1

formulasLocal

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

formulasLocal?: any[][];

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

any[][]

Комментарии

Набор API: ExcelApi 1.1

formulasR1C1

Представляет формулу в формате R1C1. Если ячейка не содержит формулы, возвращается ее значение.

formulasR1C1?: any[][];

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

any[][]

Комментарии

Набор API: ExcelApi 1.2

Представляет гиперссылку на текущий диапазон.

hyperlink?: Excel.RangeHyperlink;

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

Комментарии

Набор API: ExcelApi 1.7

numberFormat

Представляет числовой код формата Excel для заданного диапазона. Дополнительные сведения о числовом форматировании в Excel см. в статье Коды числовых форматов.

numberFormat?: any[][];

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

any[][]

Комментарии

Набор API: ExcelApi 1.1

numberFormatLocal

Представляет код числового формата Excel для заданного диапазона в соответствии с языковыми настройками пользователя. Excel не выполняет приведение языка или формата при получении или настройке numberFormatLocal свойства. В любом возвращаемом тексте используются строки локального форматирования с учетом языка, указанного в параметрах системы.

numberFormatLocal?: any[][];

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

any[][]

Комментарии

Набор API: ExcelApi 1.7

rowHidden

Указывает, все ли строки в текущем диапазоне скрыты. Значение — true это когда все строки диапазона скрыты. Значение — false это если строки в диапазоне не скрыты. Значение указывает, null когда некоторые строки в диапазоне скрыты, а другие строки в этом же диапазоне не скрыты.

rowHidden?: boolean;

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

boolean

Комментарии

Набор API: ExcelApi 1.2

style

Представляет стиль текущего диапазона. Если стили ячеек не согласованы, null будет возвращен. Для пользовательских стилей возвращается имя стиля. Для встроенных стилей будет возвращена строка, представляющая значение в перечислении BuiltInStyle .

style?: string;

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

string

Комментарии

Набор API: ExcelApi 1.7

values

Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки. Если возвращаемое значение начинается с плюса ("+"), минуса ("-") или знака равенства ("="), Excel интерпретирует это значение как формулу.

values?: any[][];

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

any[][]

Комментарии

Набор API: ExcelApi 1.1

valuesAsJson

JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJson поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту en-US. Чтобы получить данные в языковом стандарте отображения, заданном пользователем, используйте Range.valuesAsJsonLocal.

valuesAsJson?: CellValue[][];

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

Комментарии

Набор API: ExcelApi 1.16

valuesAsJsonLocal

JSON-представление значений в ячейках в этом диапазоне. В отличие от , Range.valuesRange.valuesAsJsonLocal поддерживает все типы данных, которые могут быть в ячейке. Примеры включают форматированные числовые значения и веб-изображения в дополнение к стандартным булевым, числовым и строковым значениям. Данные, возвращаемые этим API, всегда соответствуют языковому стандарту отображения, выбранному пользователем. Для получения данных, не зависящих от языкового стандарта, используйте Range.valuesAsJson.

valuesAsJsonLocal?: CellValue[][];

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

Комментарии

Набор API: ExcelApi 1.16