Поделиться через


Excel.Interfaces.RangeUpdateData interface

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

Свойства

columnHidden

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

control

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

dataValidation

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

format

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

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.valuesподдерживает Range.valuesAsJson все типы данных, которые могут находиться в ячейке. Примеры включают форматированные числовые значения и веб-изображения, а также стандартные логические, числовые и строковые значения. Данные, возвращаемые из этого API, всегда соответствуют языковому стандарту en-US. Чтобы получить данные в языковом стандарте отображения пользователя, используйте .Range.valuesAsJsonLocal

valuesAsJsonLocal

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

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

columnHidden

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

columnHidden?: boolean;

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

boolean

Комментарии

[ Набор API: ExcelApi 1.2 ]

control

Примечание

Этот API предоставляется в качестве предварительной версии для разработчиков и может быть изменен на основе полученных нами отзывов. Не используйте этот API в рабочей среде.

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

control?: CellControl;

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

Комментарии

[ Набор API: ExcelApi BETA (ТОЛЬКО ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ) ]

dataValidation

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

dataValidation?: Excel.Interfaces.DataValidationUpdateData;

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

Комментарии

[ Набор API: ExcelApi 1.8 ]

format

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

format?: Excel.Interfaces.RangeFormatUpdateData;

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

Комментарии

[ Набор API: ExcelApi 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.valuesподдерживает Range.valuesAsJson все типы данных, которые могут находиться в ячейке. Примеры включают форматированные числовые значения и веб-изображения, а также стандартные логические, числовые и строковые значения. Данные, возвращаемые из этого API, всегда соответствуют языковому стандарту en-US. Чтобы получить данные в языковом стандарте отображения пользователя, используйте .Range.valuesAsJsonLocal

valuesAsJson?: CellValue[][];

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

Комментарии

[ Набор API: ExcelApi 1.16 ]

valuesAsJsonLocal

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

valuesAsJsonLocal?: CellValue[][];

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

Комментарии

[ Набор API: ExcelApi 1.16 ]