SpreadJS製品ヘルプ
セル範囲
機能 > セル > セル範囲

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

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

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

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

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

Get Range by row and column info

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

Javascript
コードのコピー
<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のセル範囲を指定する方法を示します。

Javascript
コードのコピー
<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>