【GAS】スプレッドシートの罫線の色や太さを設定・変更する

GASでスプレッドシートの罫線の色を変更するには「setBorder(top, left, bottom, right, vertical, horizontal, color, style)」を利用する。

setBorder(top, left, bottom, right, vertical, horizontal, color, style)
枠線のプロパティに色やスタイルを設定します。有効な値は true（オン）、false（オフ）、null（変更なし）です。色には、CSS 表記の色（'#ffffff' や 'white' など）を使用します。
https://developers.google.com/apps-script/reference/spreadsheet/range#setbordertop,-left,-bottom,-right,-vertical,-horizontal,-color,-style

スプレッドシートの罫線の色を変更するGAS実行の様子

setBorder(top, left, bottom, right, vertical, horizontal, color, style)メソッドを利用して、スプレッドシートの罫線の色を変更するGASを実行してみました。

setBorder(top, left, bottom, right, vertical, horizontal, color, style)を実行することで、罫線を作成できていることがわかります。なお、罫線付与される際の内訳は以下のとおりです。

setBorder内訳	true	false
top	セル上の罫線を作成	セル上の罫線を削除
left	セル左の罫線を作成	セル左の罫線を削除
bottom	セル下の罫線を作成	セル下の罫線を削除
right	セル右の罫線を作成	セル右の罫線を削除
vertical	セル水平の罫線を作成	セル水平の罫線を削除
horizontal	セル垂直の罫線を作成	セル垂直の罫線を削除
color(String)	セル罫線の色をcss表記で変更	デフォルトはnull（黒）
style	セル罫線の太さや線の種類	デフォルトはnull（実線）

setBorder(top, left, bottom, right, vertical, horizontal, color, style)の一覧

スプレッドシートの罫線を作成・削除する場合は、以下記事を御覧ください。

参照記事：【GAS】スプレッドシートの罫線を作成・削除する

スプレッドシートの罫線の色を変更するGAS

function setbordercolor(){
  //SpreadSheetAppを起動
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  //0番目のシートを選択
  let sht = ss.getSheets()[0];
  //シートコンテンツを一旦クリア
  sht.clear();
  //YESNOでセル罫線付与作業を実行するか確認
  const yesno = Browser.msgBox("任意の範囲に青太罫線を付与しますか？",Browser.Buttons.YES_NO);
  //YESなら
  if(yesno == "yes"){
    //始点セルを取得
    const start = Browser.inputBox("始点セルを入力してください(A1形式)");
    //終点セルを取得
    const end = Browser.inputBox("終点セルを入力してください(A1形式)");
    //始点セル：終点セル範囲を取得
    const rng = sht.getRange(start+":"+end);
    //■setBorderメソッドで変数rngに青太罫線を付与
    rng.setBorder(true,true,true,true,true,true,"blue",SpreadsheetApp.BorderStyle.DOUBLE);
    //罫線付与範囲をアクティブに
    rng.activate();
    //Noなら
  }else{
    //罫線付与キャンセルの旨を掲載
    Browser.msgBox("罫線付与をキャンセルしました。");
  }
}

setBorder(top, left, bottom, right, vertical, horizontal, color, style)のパラメーター

名前	型	説明
`top`	`Boolean`	C枠線の場合は true、なしの場合は false、変更しない場合は null です。
`left`	`Boolean`	枠線の場合は true、なしの場合は false、変更しない場合は null です。
`bottom`	`Boolean`	枠線の場合は true、なしの場合は false、変更しない場合は null です。
`right`	`Boolean`	枠線の場合は true、なしの場合は false、変更しない場合は null です。
`vertical`	`Boolean`	内部の縦枠線の場合は true、なしの場合は false、変更がない場合は null です。
`horizontal`	`Boolean`	内部の水平枠線の場合は true、なしの場合は false、変更しない場合は null です。
`color`	`String`	CSS 表記の色（例: '#ffffff'、'white'）。デフォルトの色は null（黒）。
`style`	`BorderStyle`	枠線のスタイル、デフォルトのスタイル（実線）は null。