GASでスプレッドシートにチェックボックスを挿入するには「insertCheckboxes()
」を利用する。
insertCheckboxes()
範囲内の各セルにチェックボックスを挿入します。チェックボックスがオンの場合は true、オフの場合は false を指定します。範囲内のすべてのセルの値を false に設定します。
https://developers.google.com/apps-script/reference/spreadsheet/range#insertcheckboxes
スプレッドシートにチェックボックスを挿入するGAS実行の様子
insertCheckboxes()メソッドを利用して、スプレッドシートにチェックボックスを挿入するGASを実行してみました。
insertCheckboxes()を実行することで、スプレッドシートにチェックボックスを挿入されたことが分かります。
スプレッドシートに空白セルを挿入する場合は、以下記事を御覧ください。
スプレッドシートにチェックボックスを挿入する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()のパラメーター
名前 | 型 | 説明 |
---|---|---|
shiftDimension | Dimension | 既存のデータを移行するディメンション。 |
insertCheckboxes()の戻り値
Range - チェーン用の範囲。
スプレッドシートにチェックボックスを挿入するまとめ
GAS×スプレッドシートにチェックボックスを挿入するならinsertCheckboxes()
メソッドを利用しましょう。