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

GASでスプレッドシートの罫線を作成・削除するには「setBorder(top, left, bottom, right, vertical, horizontal)」を利用する。

setBorder(top, left, bottom, right, vertical, horizontal)
枠線のプロパティを設定します。有効な値は true（オン）、false（オフ）、null（変更なし）です。
https://developers.google.com/apps-script/reference/spreadsheet/range#setbordertop,-left,-bottom,-right,-vertical,-horizontal

スプレッドシートの罫線を作成・削除するGAS実行の様子

setBorder(top, left, bottom, right, vertical, horizontal)メソッドを利用して、スプレッドシートの罫線を作成・削除するGASを実行してみました。

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

setBorder内訳	true	false
top	セル上の罫線を作成	セル上の罫線を削除
left	セル左の罫線を作成	セル左の罫線を削除
bottom	セル下の罫線を作成	セル下の罫線を削除
right	セル右の罫線を作成	セル右の罫線を削除
vertical	セル水平の罫線を作成	セル水平の罫線を削除
horizontal	セル垂直の罫線を作成	セル垂直の罫線を削除

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

スプレッドシートで任意のセル背景色を設定する場合は、以下記事を御覧ください。

参照記事：【GAS】スプレッドシートで全てのセル背景色を設定する

スプレッドシートの罫線を作成・削除するGAS

function setborders(){
  //SpreadsheetAppを起動
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  //0番目のシートを取得
  let sht = ss.getSheets()[0];
　//シートのコンテンツをクリア
  sht.clear();
　//YESNOで作業有無を確認
  const yesno = Browser.msgBox("任意のセルに罫線を付与しますか？",Browser.Buttons.YES_NO_CANCEL);
  //YESなら
  if (yesno == "yes"){
    //任意のセルを入力
    const cell = Browser.inputBox("任意のセルを入力してください（A1形式）");
    //任意セルを取得
    const rng = sht.getRange(cell);
    //■setBorderで罫線を設定・背景色も設定・アクティブに
    rng.setBorder(true,true,true,true,false,false)
    .setBackground('#ccc')
    .activate();
  }else{
    //Noなら作業をキャンセル
    Browser.msgBox("作業は何もしませんでした");
  }
}

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

名前	型	説明
`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 です。