セル範囲を操作する

【GAS】スプレッドシートにチェックボックスを挿入する

GASでスプレッドシートにチェックボックスを挿入するには「insertCheckboxes()」を利用する。

insertCheckboxes()

範囲内の各セルにチェックボックスを挿入します。チェックボックスがオンの場合は true、オフの場合は false を指定します。範囲内のすべてのセルの値を false に設定します。

https://developers.google.com/apps-script/reference/spreadsheet/range#insertcheckboxes

スプレッドシートにチェックボックスを挿入するGAS実行の様子

insertCheckboxes()メソッドを利用して、スプレッドシートにチェックボックスを挿入するGASを実行してみました。

insertCheckboxes()
insertCheckboxes()を実行した様子

insertCheckboxes()を実行することで、スプレッドシートにチェックボックスを挿入されたことが分かります。

スプレッドシートに空白セルを挿入する場合は、以下記事を御覧ください。

参照記事:【GAS】スプレッドシートに空白セルを挿入する

スプレッドシートにチェックボックスを挿入するGAS

function insertcheckboxes(){
  //SpreadsheetAppを起動
  let ss = SpreadsheetApp.getActiveSpreadsheet();
  //0番目のシートを取得
  let sht = ss.getSheets()[0];
  //シートコンテンツをクリア
  sht.clear({ formatOnly: true, contentsOnly: true });
 
 //YESNOで作業を確認
  const yesno = Browser.msgBox("チェックボックスを挿入しますか?",Browser.Buttons.YES_NO_CANCEL);
  //YESなら
  if(yesno == "yes"){
    //20行コンテンツを作成して設置
    for(var i=1;i<=20;i++){
      const text = [
        ["Spread","Sheet","Blue",i]
      ];
      sht.getRange(i,1,1,4).setValues(text);
    }
    //最終行と最終列を取得
    const lastrw = sht.getLastRow();
    const lastcl = sht.getLastColumn();
    //1行目・最終列+1セルと、最終行+最終列+1セルを各A1形式で取得
    const startcell = sht.getRange(1,lastcl+1).getA1Notation();
    const endcell = sht.getRange(lastrw,lastcl+1).getA1Notation();
  //■insertCheckboxesメソッドで指定範囲にチェックボックスを挿入
    sht.getRange(startcell+":"+endcell).insertCheckboxes();
  //見出しテキストを作成
    const midashi = [
      ["項目","内容","備考","No","check"]
    ];
  //1行目に空白行を挿入し、見出しテキストを設置
    sht.insertRows(1);
    sht.getRange(1,1,1,lastcl+1).setValues(midashi);
  //チェックボックスを設置した旨を掲載
    Browser.msgBox("チェックボックスを挿入しました");
  }else{
    //Noなら作業中止の旨を掲載
    Browser.msgBox("作業を中止しました");
  }
}

insertCheckboxes()のパラメーター

名前説明
shiftDimensionDimension既存のデータを移行するディメンション。
insertCheckboxes()のパラメーター

insertCheckboxes()の戻り値

Range - チェーン用の範囲。

スプレッドシートにチェックボックスを挿入するまとめ

GAS×スプレッドシートにチェックボックスを挿入するならinsertCheckboxes()メソッドを利用しましょう。

関連記事:【GAS】スプレッドシートの空白セルを判定する

関連記事:【GAS】スプレッドシートに複数行を挿入する

関連記事:【GAS】スプレッドシートの指定行の後ろに複数行を追加する

関連記事:【GAS】スプレッドシートの指定行の前に複数行を追加する

-セル範囲を操作する