【GAS】スプレッドシートの枠線設定機能まとめ【サンプルソース付】

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

GAS開発者向けにスプレッドシートの枠線設定機能をすべてまとめました。

表を作成する際、枠線を付けた方が圧倒的に見やすくなりますね。

スプレッドシートの枠線操作はExcelと結構違うので、GASで簡単に設定できるようになるととても便利です。

枠線設定に関するメソッドをすべて載せてます。少しでも参考になれば幸いです。


スポンサーリンク

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

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

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

 

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

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

 

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

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

 

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

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

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


枠線スタイル列挙型[BorderStyle]

枠線のスタイルです。

Enum BorderStyle
Range.setBorder(上、左、下、右、垂直、水平、色、スタイル)を使用して範囲に設定できるスタイル。

Properties
プロパティタイプ説明
DOTTEDEnum点線の境界線。
DASHEDEnum破線の境界線。
SOLIDEnum細い実線の境界線。
SOLID_MEDIUMEnum中実線の境界線。
SOLID_THICKEnum太い実線の境界線。
DOUBLEEnum2本の実線の境界線。

参照:Google Apps Script | REFERENCE | SpreadSheet | Enum BorderStyle


セル範囲クラス[Range]の枠線設定

セル範囲の枠線設定メソッドです。

枠線設定[setBorder(上, 左, 下, 右, 垂直, 水平)]

setBorder(top, left, bottom, right, vertical, horizontal)
ボーダープロパティを設定します。有効な値は、true(オン)、false(オフ)、およびnull(変更なし)です。

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

  var cell = sheet.getRange("B2");
  // 上下の境界線を設定しますが、左右は変更しません
  cell.setBorder(true, null, true, null, false, false);
}
Parameters
名前タイプ説明
topBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
leftBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
bottomBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
rightBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
verticalBoolean内部の垂直方向の境界線ではtrue、なしではfalse、変更なしではnullです。
horizontalBoolean内部の水平方向の境界線の場合はtrue、なしの場合はfalse、変更なしの場合はnull。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setBorder(top, left, bottom, right, vertical, horizontal)

枠線設定(色スタイル付)[setBorder(上, 左, 下, 右, 垂直, 水平, 色, スタイル)]

setBorder(top, left, bottom, right, vertical, horizontal, color, style)
ボーダープロパティを色やスタイルで設定します。有効な値は、true(オン)、false(オフ)、およびnull(変更なし)です。色については、CSS表記で色を使用します( '#ffffff'や 'white'など)。

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

  var cell = sheet.getRange("B2");
  // 上下の境界線を設定しますが、左右は変更しません。
  // また、色を「赤」に設定し、境界線を「DASHED」に設定します。
  cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);
}
Parameters
名前タイプ説明
topBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
leftBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
bottomBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
rightBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
verticalBoolean内部の垂直方向の境界線の場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
horizontalBoolean内部の水平方向の境界線の場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
colorStringCSS表記の色( '#ffffff'や 'white'など)。デフォルトの色(黒)の場合はnullです。
styleBorderStyle境界線のスタイル。デフォルトスタイル(実線)の場合はnullです。

Return
Range - 連鎖用のセル範囲。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class Range | Methods | setBorder(top, left, bottom, right, vertical, horizontal, color, style)




セル範囲リストクラス[RangeList]の枠線設定

セル範囲リストの枠線設定メソッドです。

枠線設定[setBorder(上, 左, 下, 右, 垂直, 水平)]

setBorder(top, left, bottom, right, vertical, horizontal)
範囲リスト内の各範囲の境界プロパティを設定します。有効な値は、true(オン)、false(オフ)、およびnull(変更なし)です。

function setBorderSample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
  // A2:B4とC1:D4の範囲の上下に境界線を設定しますが、
  // 左右は変更しません。
  rangeList.setBorder(true, null, true, null, false, false);
}
Parameters
名前タイプ説明
topBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
leftBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
bottomBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
rightBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
verticalBoolean内部の垂直方向の境界線の場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
horizontalBoolean内部の水平方向の境界線の場合はtrue、なしの場合はfalse、変更なしの場合はnullです。

Return
RangeList - 連鎖用のセル範囲リスト。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class RangeList | Methods | setBorder(top, left, bottom, right, vertical, horizontal)

枠線設定(色スタイル付)[setBorder(上, 左, 下, 右, 垂直, 水平, 色, スタイル)]

setBorder(top, left, bottom, right, vertical, horizontal, color, style)
範囲リスト内の各範囲に対して、色またはスタイル(あるいはその両方)でborderプロパティを設定します。有効な値は、true(オン)、false(オフ)、およびnull(変更なし)です。色はCSS表記で表されます。たとえば、「#ffffff」や「white」などです。

function setBorderColorStyleSample() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
  // 上下の境界線を設定しますが、A2:B4およびC1:D4の範囲で左右は変わりません。
  // 色を 'red'に、枠線を​​ 'DASHED'にも設定します。
  rangeList.setBorder(
  true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);
}
Parameters
名前タイプ説明
topBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
leftBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
bottomBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
rightBooleanボーダーの場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
verticalBoolean内部の垂直方向の境界線の場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
horizontalBoolean内部の水平方向の境界線の場合はtrue、なしの場合はfalse、変更なしの場合はnullです。
colorString#ffffff'や 'white'のようなCSS表記の境界色。デフォルトの色(黒)の場合はnullです。
styleBorderStyle境界線のスタイル。デフォルトスタイル(実線)の場合はnullです。

Return
RangeList - 連鎖用のセル範囲リスト。

参照:Google Apps Script | REFERENCE | SpreadSheet | Class RangeList | Methods | setBorder(top, left, bottom, right, vertical, horizontal, color, style)


最後に

GAS枠線設定機能のまとめをご紹介させていただきました。

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

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

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

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

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

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

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

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

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




コメント