Тип ресурса workbookRange

Статья
06/13/2024

Пространство имен: microsoft.graph

Представляет набор из одной или нескольких смежных ячеек в книге, таких как ячейка, строка, столбец или блок ячеек.

Методы

Метод	Возвращаемый тип	Описание
Получение	workbookRange	Чтение свойств и связей объекта диапазона.
Обновление	workbookRange	Обновление объекта диапазона.
удаление;	Нет	Удалите ячейки, связанные с диапазоном.
Clear	Нет	Очистите значения диапазона, формат, заливку или границу.
Получение ограничивающегоrect	workbookRange	Получите наименьший объект диапазона, охватывающий заданные диапазоны. Например, GetBoundingRect для "B2:C5" и "D10:E15" — "B2:E16".
Получение ячейки	workbookRange	Возвращает объект диапазона, содержащий одну ячейку, на основе номеров строк и столбцов. Ячейка может находиться за пределами родительского диапазона, если она находится в сетке листа. Возвращаемая ячейка располагается относительно верхней левой ячейки диапазона.
Получение столбца	workbookRange	Получение столбца, содержащегося в диапазоне.
Получение столбцов после	workbookRangeView	Получение нескольких столбцов справа от заданного диапазона.
Получение столбцов до	workbookRangeView	Получение нескольких столбцов слева от заданного диапазона.
Получение всего столбца	workbookRange	Получите объект , представляющий весь столбец диапазона.
Получение всей строки	workbookRange	Возвращает объект, представляющий всю строку диапазона.
Получение пересечения	workbookRange	Получите объект диапазона, представляющий прямоугольное пересечение заданных диапазонов.
Получение последней ячейки	workbookRange	Получение последней ячейки в диапазоне. Например, последняя ячейка диапазона B2:D5 — D5.
Получение последнего столбца	workbookRange	Получение последнего столбца в диапазоне. Например, последний столбец диапазона B2:D5 — D2:D5.
Получение последней строки	workbookRange	Возвращает последнюю строку в диапазоне. Например, последняя строка в диапазоне "B2:D5" — "B5:D5".
Получение диапазона смещения	workbookRange	Получите объект , представляющий диапазон, который смещается от указанного диапазона. Измерение возвращаемого диапазона соответствует этому диапазону. Если полученный диапазон выходит за пределы таблицы листа, вызывается исключение.
Получение измененного диапазона	workbookRangeView	Получите объект диапазона, аналогичный текущему объекту диапазона, но с его правым нижним углом, развернутым (или с сокращением) на некоторое количество строк и столбцов.
Получение строки	workbookRange	Получение строки, содержащейся в диапазоне.
Получение строк выше	workbookRangeView	Получение нескольких строк выше заданного диапазона.
Получение строк ниже	workbookRangeView	Получение строк ниже заданного диапазона.
Получение используемого диапазона	workbookRange	Возвращает используемый диапазон заданного объекта диапазона.
Получение видимого представления	workbookRangeView	Обеспечивает отображение диапазона в отфильтрованном диапазоне.
Вставка диапазона	workbookRange	Вставьте ячейку или диапазон ячеек на лист вместо этого диапазона и перемещает другие ячейки, чтобы освободить место. Возвращает новый объект Range в пустом месте.
Merge	Нет	Объединяет ячейки диапазона в одну область на листе.
Unmerge	Нет	Разъединяет ячейки диапазона на отдельные ячейки.

Свойства

Свойство	Тип	Описание
address	string	Представляет ссылку на диапазон в стиле A1. Значение address содержит ссылку на лист (например, Лист1! A1:B4). Только для чтения.
addressLocal	string	Представляет ссылку на указанный диапазон на языке пользователя. Только для чтения.
cellCount	int	Количество ячеек в диапазоне. Только для чтения.
columnCount	int	Представляет общее количество столбцов в диапазоне. Только для чтения.
columnHidden	Логический	Указывает, скрыты ли все столбцы текущего диапазона.
columnIndex	int	Представляет номер столбца первой ячейки диапазона. Используется нулевой индекс. Только для чтения.
formulas	Json	Представляет формулу в формате A1.
formulasLocal	Json	Представляет формулу в формате A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке.
formulasR1C1	Json	Представляет формулу в формате R1C1.
hidden	boolean	Указывает, скрыты ли все ячейки текущего диапазона. Только для чтения.
numberFormat	Json	Представляет код в числовом формате Excel для данной ячейки.
rowCount	int	Возвращает общее количество строк в диапазоне. Только для чтения.
rowHidden	Логический	Указывает, скрыты ли все строки текущего диапазона.
rowIndex	int	Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс. Только для чтения.
text	Json	Текстовые значения указанного диапазона. Значение Text не зависит от ширины ячейки. Подстановка знака #, выполняемая в пользовательском интерфейсе Excel, не влияет на текстовое значение, возвращаемое API. Только для чтения.
valueTypes	Json	Представляет тип данных каждой ячейки. Возможные значения: `Unknown`, `Empty`, `String`, `Integer`, `Double`, `Boolean`, `Error`. Только для чтения.
values	Json	Представляет необработанные значения указанного диапазона. Возвращаемые данные могут быть типа string, number или boolean. Ячейка, содержащая ошибку, возвращает строку ошибки.

Связи

Связь	Тип	Описание
format	workbookRangeFormat	Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона. Только для чтения.
sort	workbookRangeSort	Лист, содержащий текущий диапазон. Только для чтения.
лист	workbookWorksheet	Лист, содержащий текущий диапазон. Только для чтения.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "address": "string",
  "addressLocal": "string",
  "cellCount": 1024,
  "columnCount": 1024,
  "columnHidden": true,
  "columnIndex": 1024,
  "formulas": "json",
  "formulasLocal": "json",
  "formulasR1C1": "json",
  "hidden": true,
  "numberFormat": "json",
  "rowCount": 1024,
  "rowHidden": true,
  "rowIndex": 1024,
  "text": "json",
  "valueTypes": "string",
  "values": "json"
}

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