Spread.Sheetsでは、指定したシート領域内のセル範囲を取得できます。シート内のセル範囲を取得するには、getRangeメソッドを使用します。
また、要件に応じて、行/列インデックスまたは範囲アドレスを使用して、シート領域内のセル範囲を取得できます。これらの方法については、以下で解説しています。
getRange(row, col, rowCount, colCount, sheetArea)メソッドを使用して、指定したシート領域内のセル範囲を取得できます。このメソッドは、行インデックス、列インデックス、範囲の行数、範囲の列数をパラメータとして受け取ります。これにより、行/列インデックスによって指定したシート領域内のセル範囲を取得できます。
次の図は、行/列のインデックスを使用してセル範囲を取得する例を示します。
次のサンプルコードは、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)メソッドを使用して、指定したシート領域内のセル範囲を取得できます。このメソッドは、範囲アドレスの文字列を使用して、指定したシート領域のセル範囲を取得します。
次の図は、範囲アドレスを使用してセル範囲を取得する例を示します。
次のサンプルコードは、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> |
getUsedRangeメソッドを使用して、ワークシート内にデータのタイプに基づいてセル範囲を取得できます。UsedRangeType列挙型をパラメータとして使用して、データのタイプの最大範囲をすばやく取得します。
スパークライン、チャート、スライサーなどのさまざまなデータの形式を操作するときに、ワークシート全体でさまざまなデータ範囲をすばやく取得するのに役立ちます。
次のサンプルコードは、ワークシートにスタイルが適用されたセル範囲を選択する方法を示します。
JavaScript |
コードのコピー
|
---|---|
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); } |