セル範囲

Spread.Sheetsでは、指定したシート領域内のセル範囲を取得できます。シート内のセル範囲を取得するには、getRangeメソッドを使用します。

また、要件に応じて、行／列インデックスまたは範囲アドレスを使用して、シート領域内のセル範囲を取得できます。これらの方法については、以下で解説しています。

行／列インデックスによるセル範囲の取得

getRange(row, col, rowCount, colCount, sheetArea) メソッドを使用して、指定したシート領域内のセル範囲を取得できます。このメソッドは、行インデックス、列インデックス、範囲の行数、範囲の列数をパラメータとして受け取ります。これにより、行／列インデックスによって指定したシート領域内のセル範囲を取得できます。

次の図は、行／列のインデックスを使用してセル範囲を取得する例を示します。

Get Range by row and column info

次のサンプルコードは、 getRange メソッドを使用して、行／列のインデックスでB2：F6のセル範囲を指定する方法を示します。

<script>
    $(document).ready(function () {
        // Spreadを初期化します。
        var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
        // アクティブシートを取得します。
        var sheet = spread.getActiveSheet();

        // 行と列の情報でセル範囲を取得します。
        var range = sheet.getRange(1, 1, 5, 5, GC.Spread.Sheets.SheetArea.viewport);
        range.text("テキスト");
    });
</script>

範囲アドレスによるセル範囲の取得

getRange(address, sheetArea) メソッドを使用して、指定したシート領域内のセル範囲を取得できます。このメソッドは、範囲アドレスの文字列を使用して、指定したシート領域のセル範囲を取得します。

次の図は、範囲アドレスを使用してセル範囲を取得する例を示します。

Get Range by range address

次のサンプルコードは、 getRange メソッドを使用して、範囲アドレスでA1:E5のセル範囲を指定する方法を示します。

<script>
    $(document).ready(function () {
        // Spreadを初期化します。
        var spread = new GC.Spread.Sheets.Workbook(document.getElementById('ss'), { sheetCount: 1 });
        // アクティブシートを取得します。
        var sheet = spread.getActiveSheet();

        // 範囲アドレスでセル範囲を取得します。
        var range = sheet.getRange('A1:E5', GC.Spread.Sheets.SheetArea.viewport);
        range.text("テキスト");
    });
</script>

データのタイプによるセル範囲の取得

getUsedRangeメソッドを使用して、ワークシート内にデータのタイプに基づいてセル範囲を取得できます。UsedRangeType列挙型をパラメータとして使用して、データのタイプの最大範囲をすばやく取得します。

スパークライン、チャート、スライサーなどのさまざまなデータの形式を操作するときに、ワークシート全体でさまざまなデータ範囲をすばやく取得するのに役立ちます。

SpreadJS Get Range by Type of Data

次のサンプルコードは、ワークシートにスタイルが適用されたセル範囲を選択する方法を示します。

function getRangeStyle() {
    var sheet = spread.getSheet(0);
    var styleRange = sheet.getUsedRange(GC.Spread.Sheets.UsedRangeType.style);
    //  styleRange:{row: 2, col: 2, rowCount: 3, colCount: 3}

    sheet.setSelection(styleRange.row, styleRange.col, styleRange.rowCount, styleRange.colCount, GC.Spread.Sheets.SheetArea.viewport, GC.Spread.Sheets.StorageType.style);
}