Тип ресурса RangeRange resource type

Объект Range представляет собой набор из одной или нескольких смежных ячеек, например ячейку, строку, столбец, блок ячеек и т. д.Range represents a set of one or more contiguous cells such as a cell, a row, a column, block of cells, etc.

МетодыMethods

МетодMethod Возвращаемый типReturn Type ОписаниеDescription
Получение объекта RangeGet Range RangeRange Чтение свойств и связей объекта диапазона.Read properties and relationships of range object.
ОбновлениеUpdate RangeRange Обновление объекта Range.Update Range object.
BoundingrectBoundingrect RangeRange Возвращает наименьший объект диапазона, включающий в себя заданные диапазоны. Например, GetBoundingRect для "B2:C5" и "D10:E15" — "B2:E16".Gets the smallest range object that encompasses the given ranges. For example, the GetBoundingRect of "B2:C5" and "D10:E15" is "B2:E16".
CellCell RangeRange Получает объект диапазона, содержащий одну ячейку, на основе номера строки и столбца. Ячейка может быть вне родительского диапазона, если она расположена в таблице листа. Возвращаемая ячейка располагается относительно верхней левой ячейки диапазона.Gets the range object containing the single cell based on row and column numbers. The cell can be outside the bounds of its parent range, so long as it's stays within the worksheet grid. The returned cell is located relative to the top left cell of the range.
ColumnColumn RangeRange Возвращает столбец в диапазоне.Gets a column contained in the range.
ColumnsafterColumnsafter workbookRangeViewworkbookRangeView Возвращает определенное количество столбцов справа от заданного диапазона.Gets a certain number of columns to the right of the given range.
ColumnsbeforeColumnsbefore workbookRangeViewworkbookRangeView Возвращает определенное количество столбцов слева от заданного диапазона.Gets a certain number of columns to the left of the given range.
EntirecolumnEntirecolumn RangeRange Возвращает объект, представляющий весь столбец диапазона.Gets an object that represents the entire column of the range.
EntirerowEntirerow RangeRange Возвращает объект, представляющий всю строку диапазона.Gets an object that represents the entire row of the range.
IntersectionIntersection RangeRange Возвращает объект диапазона, представляющий прямоугольное пересечение заданных диапазонов.Gets the range object that represents the rectangular intersection of the given ranges.
LastcellLastcell RangeRange Возвращает последнюю ячейку в диапазоне. Например, последняя ячейка диапазона B2:D5 — D5.Gets the last cell within the range. For example, the last cell of "B2:D5" is "D5".
LastcolumnLastcolumn RangeRange Возвращает последний столбец в диапазоне. Например, последний столбец диапазона B2:D5 — D2:D5.Gets the last column within the range. For example, the last column of "B2:D5" is "D2:D5".
LastrowLastrow RangeRange Возвращает последнюю строку в диапазоне. Например, последняя строка в диапазоне "B2:D5" — "B5:D5".Gets the last row within the range. For example, the last row of "B2:D5" is "B5:D5".
OffsetrangeOffsetrange RangeRange Возвращает объект, представляющий диапазон, который смещен от указанного диапазона. Измерение возвращаемого диапазона будет соответствовать этому диапазону. Если результирующий диапазон выходит за пределы таблицы листа, вызывается исключение.Gets an object which represents a range that's offset from the specified range. The dimension of the returned range will match this range. If the resulting range is forced outside the bounds of the worksheet grid, an exception will be thrown.
RowRow RangeRange Возвращает строку из диапазона.Gets a row contained in the range.
RowsaboveRowsabove workbookRangeViewworkbookRangeView Возвращает определенное количество строк над заданным диапазоном.Gets a certain number of rows above a given range.
RowsbelowRowsbelow workbookRangeViewworkbookRangeView Возвращает определенное количество строк под заданным диапазоном.Gets a certain number of rows below a given range.
UsedrangeUsedrange RangeRange Возвращает используемый диапазон заданного объекта диапазона.Returns the used range of the given range object.
ClearClear НетNone Очищает значения, формат, заливку, границу диапазона и т. д.Clear range values, format, fill, border, etc.
DeleteDelete НетNone Удаляет ячейки, связанные с диапазоном.Deletes the cells associated with the range.
InsertInsert RangeRange Вставляет ячейку или диапазон ячеек на лист вместо этого диапазона, а также сдвигает другие ячейки, чтобы освободить место. Возвращает новый объект Range в пустом месте.Inserts a cell or a range of cells into the worksheet in place of this range, and shifts the other cells to make space. Returns a new Range object at the now blank space.
MergeMerge НетNone Объединяет ячейки диапазона в одну область на листе.Merge the range cells into one region in the worksheet.
ResizedrangeResizedrange workbookRangeViewworkbookRangeView Возвращает объект диапазона, подобный текущему объекту диапазона, но увеличенный (или уменьшенный) на некоторое количество строк и столбцов в правом нижнем углу.Gets a range object similar to the current range object, but with its bottom-right corner expanded (or contracted) by some number of rows and columns.
UnmergeUnmerge НетNone Разъединяет ячейки диапазона на отдельные ячейки.Unmerge the range cells into separate cells.
VisibleviewVisibleview workbookRangeViewworkbookRangeView Обеспечивает отображение диапазона в отфильтрованном диапазоне.Get the range visible from a filtered range.

СвойстваProperties

СвойствоProperty ТипType ОписаниеDescription
addressaddress stringstring Представляет ссылку на диапазон в стиле A1. Значение адреса будет содержать ссылку на лист (например, Лист1!A1:B4). Только для чтения.Represents the range reference in A1-style. Address value will contain the Sheet reference (e.g. Sheet1!A1:B4). Read-only.
addressLocaladdressLocal stringstring Представляет ссылку на указанный диапазон на языке пользователя. Только для чтения.Represents range reference for the specified range in the language of the user. Read-only.
cellCountcellCount intint Количество ячеек в диапазоне. Только для чтения.Number of cells in the range. Read-only.
columnCountcolumnCount intint Представляет общее количество столбцов в диапазоне. Только для чтения.Represents the total number of columns in the range. Read-only.
columnHiddencolumnHidden booleanboolean Указывает, скрыты ли все столбцы текущего диапазона.Represents if all columns of the current range are hidden.
columnIndexcolumnIndex intint Представляет номер столбца первой ячейки диапазона. Используется нулевой индекс. Только для чтения.Represents the column number of the first cell in the range. Zero-indexed. Read-only.
formulasformulas JsonJson Представляет формулу в формате A1.Represents the formula in A1-style notation.
formulasLocalformulasLocal JsonJson Представляет формулу в нотации стиля A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке.Represents the formula in A1-style notation, in the user's language and number-formatting locale. For example, the English "=SUM(A1, 1.5)" formula would become "=SUMME(A1; 1,5)" in German.
formulasR1C1formulasR1C1 JsonJson Представляет формулу в формате R1C1.Represents the formula in R1C1-style notation.
hiddenhidden booleanboolean Указывает, скрыты ли все ячейки текущего диапазона. Только для чтения.Represents if all cells of the current range are hidden. Read-only.
numberFormatnumberFormat JsonJson Представляет код в числовом формате Excel для данной ячейки.Represents Excel's number format code for the given cell.
rowCountrowCount intint Возвращает общее количество строк в диапазоне. Только для чтения.Returns the total number of rows in the range. Read-only.
rowHiddenrowHidden booleanboolean Указывает, скрыты ли все строки текущего диапазона.Represents if all rows of the current range are hidden.
rowIndexrowIndex intint Возвращает номер строки первой ячейки диапазона. Используется нулевой индекс. Только для чтения.Returns the row number of the first cell in the range. Zero-indexed. Read-only.
текстtext JsonJson Текстовые значения указанного диапазона. Текстовое значение не зависит от ширины ячейки. Замена знака #, которая происходит в пользовательском интерфейсе Excel, не повлияет на текстовое значение, возвращаемое API. Только для чтения.Text values of the specified range. The Text value will not depend on the cell width. The # sign substitution that happens in Excel UI will not affect the text value returned by the API. Read-only.
valueTypesvalueTypes JsonJson Представляет тип данных каждой ячейки.Represents the type of data of each cell. Возможные значения: Unknown, Empty, String, Integer, Double, Boolean, Error.The possible values are: Unknown, Empty, String, Integer, Double, Boolean, Error. Только для чтения.Read-only.
valuesvalues JsonJson Представляет необработанные значения указанного диапазона. Могут возвращаться строковые и числовые данные, а также логические значения. Ячейка, которая содержит ошибку, вернет строку ошибки.Represents the raw values of the specified range. The data returned could be of type string, number, or a boolean. Cell that contain an error will return the error string.

СвязиRelationships

ОтношениеRelationship ТипType ОписаниеDescription
formatformat WorkbookRangeFormatWorkbookRangeFormat Возвращает объект формата, в который включены шрифт, заливка, границы, выравнивание и другие свойства диапазона. Только для чтения.Returns a format object, encapsulating the range's font, fill, borders, alignment, and other properties. Read-only.
sortsort WorkbookRangeSortWorkbookRangeSort Лист, содержащий текущий диапазон. Только для чтения.The worksheet containing the current range. Read-only.
worksheetworksheet WorkbookWorksheetWorkbookWorksheet Лист, содержащий текущий диапазон.The worksheet containing the current range. Только для чтения.Read-only.

Представление JSONJSON representation

Ниже представлено описание ресурса в формате JSON.Here is a JSON representation of the resource.

{
  "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"
}