【GAS】スプレッドシートの行列サイズ機能まとめ【サンプルソース付】

快速ワーク
スポンサーリンク

GAS開発者向けにスプレッドシートの行列サイズ機能をすべてまとめました。

セル内のデータの長さ、改行などによって見映えが美しくない時、行と列のサイズを調整して美しくしたい時ってありますよね。

行の高さや列の幅の変更です。複数行や複数列まとめて変更も可能です。

行列サイズに関するメソッドをすべて載せてます。少しでも参考になれば幸いです。


スポンサーリンク

Google Apps Script スプレッドシート 基礎 リファレンス

当ページは、GAS公式リファレンスを元にスプレッドシートの機能毎にまとめた基礎的な内容となっております。

若干、文言がおかしい可能性がありますが、あらかじめご了承ください。

 

GAS基本メソッドまとめ一覧はコチラ↓↓↓です。スプレッドシートの基本的な機能をまとめてますので、ぜひご活用ください。

【GAS】スプレッドシート基本メソッドまとめ一覧【初心者入門】
GAS開発者向けにスプレッドシートの基本的なメソッドを一覧にまとめました。各機能ごとのクラス、メソッドごとのサンプルソース付ページへリンクする一覧です。初心者にとって、スプレッドシートの基本的な操作・機能単位のメソッドを知...

 

まずは実際に動かしてみることをオススメします。マクロの登録方法は以下を参照いただければと思います。

【GAS】Googleスプレッドシートでマクロの使い方入門【動画付】
Googleの「Google Apps Script」通称GAS。GoogleマップやGメールなど、いろんなGoogle関連のサービスと自由に連携できたり、独自のWebアプリを開発することもできる、いろんな可能性を秘めたワクワクの...

 

GASの本はまだまだ少ないですね。基礎レベルであれば、以下の参考書が初心者にはベストの本です。

基本的な仕様やよく使われる機能の設定方法がまとまっています。

※JavaScriptの知識が既にある程度ある人にとっては冗長かもしれません。


シートクラス[Sheet]の行列サイズ設定

シートの行と列のサイズ設定メソッドです。

行の高さ設定[setRowHeight(行の位置, 高さ)]

setRowHeight(rowPosition, height)
指定された行の行の高さをピクセル単位で設定します。

function setRowHeightSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 最初の行を200ピクセルの高さに設定します
  sheet.setRowHeight(1, 200);
}
Parameters
名前タイプ説明
rowPositionInteger変更する行位置。
heightInteger設定する高さ(ピクセル単位)。

Return
Sheet - メソッド連鎖に有効なシート。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | setRowHeight(rowPosition, height)

列の幅設定[setColumnWidth(列の位置, 幅)]

setColumnWidth(columnPosition, width)
指定された列の幅をピクセル単位で設定します。

function setColumnWidthSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 最初の列を200ピクセルの幅に設定します
  sheet.setColumnWidth(1, 200);
}
Parameters
名前タイプ説明
columnPositionInteger設定する特定の列の位置。
widthInteger設定する幅(ピクセル単位)。

Return
Sheet - メソッド連鎖に有効なシート。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | setColumnWidth(columnPosition, width)

複数行の高さ設定[setRowHeights(開始行, 行数, 高さ)]

setRowHeights(startRow, numRows, height)
指定された行の高さをピクセル単位で設定します。

function setRowHeightsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 最初の3行を20ピクセルの高さに設定します
  sheet.setRowHeights(1, 3, 20);
}
Parameters
名前タイプ説明
startRowInteger変更する開始行位置。
numRowsInteger変更する行数。
heightInteger設定する高さ(ピクセル単位)。

Return
Sheet - 連鎖用のシート。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | setRowHeights(startRow, numRows, height)

複数列の幅設定[setColumnWidths(開始列, 列数, 幅)]

setColumnWidths(startColumn, numColumns, width)
指定された列の幅をピクセル単位で設定します。

function setColumnWidthsSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 最初の3列を200ピクセルの幅に設定します
  sheet.setColumnWidths(1, 3, 200);
}
Parameters
名前タイプ説明
startColumnInteger変更する開始列位置。
numColumnsInteger変更する列数。
widthInteger設定する幅(ピクセル単位)。

Return
Sheet - 連鎖用のシート。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | setColumnWidths(startColumn, numColumns, width)




シートクラス[Sheet]の行列サイズ取得

シートの行と列のサイズ取得メソッドです。

行の高さ取得[getRowHeight(行の位置)]

getRowHeight(rowPosition)
指定された行の高さをピクセル単位で取得します。

function getRowHeightSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 1から始まる行
  Logger.log(sheet.getRowHeight(1));
}
Parameters
名前タイプ説明
rowPositionInteger調べる行の位置。

Return
Integer - 行の高さ(ピクセル)。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | getRowHeight(rowPosition)

列の幅取得[getColumnWidth(列の位置)]

getColumnWidth(columnPosition)
指定された列の幅をピクセル単位で取得します。

function getColumnWidthSample() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  // 列は1から始まります
  Logger.log(sheet.getColumnWidth(1));
}
Parameters
名前タイプ説明
columnPositionInteger調べる列の位置。

Return
Integer - ピクセル単位の列幅。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Sheet | Methods | getColumnWidth(columnPosition)


最後に

GAS行列サイズ機能のまとめをご紹介させていただきました。

必要に応じて、有益な情報でさらに更新していきたいと思います。

プログラミングスキルを向上させるためには、本を読むだけでは脳にインプットされませんね。

実際に手を動かしてアウトプットしまくるのが一番の近道だと思います。

実際にサンプルソースをコピーして実行した結果がどうなるかを体験してみてください。

自分なりのアレンジを加えたり、なぜエラーになるのかを考え、何度も試行錯誤して問題を解決しまくり、着実に理解しながらスキルを向上させていきましょう。

GASはExcelVBAとはかなり違いますが、ベースとなっているJavaScriptは覚えて損はないプログラミング言語なのでショートカットキーなどと組み合わせてぜひ活用してみてください。

Googleスプレッドシート全ショートカットキー一覧はこちら↓↓↓

Googleスプレッドシートの使い方や機能がわかるショートカットキー全まとめ一覧【初心者こそ必見】
表計算ソフトとして、まだまだExcelのシェア率は高いですが、GoogleスプレッドシートにはExcelにはない超強力な関数があったり、Excelとは違って常に最新版を無料で使用できます。なにより、インターネットを使ったオンライン...

ショートカットキー一覧にもGASメソッドを載せています。どの操作からどのメソッドが呼ばれるのかイメージしてください。




コメント

//▼2023/04/08追加 //https://lovagelab.com/posts/3406/ //▲2023/04/08追加