【GAS】スプレッドシートのチェックボックスのチェックを外す

2024年10月9日

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

uncheck()

範囲内のチェックボックスの状態を「オフ」に変更します。現在、構成された値またはオフになっている値の両方を含まないセルの範囲は無視されます。
https://developers.google.com/apps-script/reference/spreadsheet/range#uncheck

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

uncheck() メソッドを利用して、スプレッドシートのチェックボックスのチェックを外すGASを実行してみました。

uncheck()を実行することで、

任意のセル範囲（1セル・配列範囲）に対し、チェックボックスにあるチェックを一括で外す

といった操作が可能です。

スプレッドシートでチェックボックスを全て削除する場合は、以下記事を御覧ください。

参照記事：【GAS】スプレッドシートでチェックボックスを全て削除する

スプレッドシートのチェックボックスのチェックを外すGAS

//--checkbox作成して一括チェック
    function check() {
    //SpreadsheetAppを起動してシートアクティブに
     let ss = SpreadsheetApp.getActiveSheet();
    //変数rangeに10行1列の範囲を格納
     const range = ss.getRange(1,1,10,1);
    //rangeにチェックボックスを設定
     range.setValue('true').insertCheckboxes();
    //チェックボックスの値を判定←不要かも
     range.isChecked();
    }
     
    //--checkboxのチェックをすべてオフに
    //SpreadsheetAppを起動してシートアクティブに
     let ss = SpreadsheetApp.getActiveSheet();
    //変数rangeに10行1列の範囲を格納
     const range = ss.getRange(1,1,10,1);
    //■range範囲のチェックをすべて外す
     range.uncheck();
    }