範囲リソースの種類Range resource type

範囲は、1 つ以上の隣接するセル (セル、行、列、セルのブロックなど) のセットを表します。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
範囲を取得するGet Range RangeRange 範囲オブジェクトのプロパティと関係を読み取ります。Read properties and relationships of range object.
UpdateUpdate RangeRange 範囲オブジェクトを更新します。Update Range object.
BoundingrectBoundingrect RangeRange 指定した範囲を包含する、最小の Range オブジェクトを取得します。たとえば、"B2:C5" と "D10:E15" の GetBoundingRect は、"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 行と列の番号に基づいて、1 つのセルを含んだ範囲オブジェクトを取得します。以外このセルは、ワークシートのグリッド内であれば、親の範囲の境界の外のセルであってもかまいません。返されるセルは、範囲の左上のセルを基準に配置されます。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 範囲に含まれる列を 1 つ取得します。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 範囲に含まれている行を 1 つ取得します。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 範囲内のセルをワークシートの 1 つの領域に結合します。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 スタイルの範囲参照を表します。アドレス値には、シート参照が格納されます (例: Sheet1!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 範囲に含まれる最初のセルの列番号を表します。0 を起点とする番号になります。読み取り専用です。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)" は、ドイツ語では "=SUMME(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 範囲に含まれる最初のセルの行番号を返します。0 を起点とする番号になります。読み取り専用です。Returns the row number of the first cell in the range. Zero-indexed. Read-only.
texttext JsonJson 指定した範囲のテキスト値。テキスト値は、セルの幅には依存しません。Excel UI で発生する # 記号による置換は、この 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. 使用可能な値: UnknownEmptyStringIntegerDoubleBooleanErrorThe possible values are: Unknown, Empty, String, Integer, Double, Boolean, Error. 読み取り専用です。Read-only.
valuesvalues JsonJson 指定した範囲の Raw 値を表します。返されるデータの型は、文字列、数値、またはブール値のいずれかになります。エラーが含まれているセルは、エラー文字列を返します。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 Format オブジェクト (範囲のフォント、塗りつぶし、罫線、配置などのプロパティをカプセル化するオブジェクト) を返します。読み取り専用です。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.
ワークシートworksheet WorkbookWorksheetWorkbookWorksheet 現在の範囲を含んでいるワークシート。読み取り専用です。The worksheet containing the current range. Read-only.

JSON 表記JSON 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"
}