メッセージを操作する

【GAS】スプレッドシートのメッセージアラートにボタンを付与する

GASでスプレッドシートのメッセージアラートにボタンを付与するには「alert(prompt,buttons) 」を利用する。

alert(prompt,buttons)

ユーザーのエディタで、指定されたメッセージとボタンのセットを含むダイアログ ボックスを開きます。このメソッドは、ダイアログが開いている間にサーバー側のスクリプトを停止します。ユーザーがダイアログを閉じるとスクリプトが再開されますが、Jdbc 接続と LockService ロックは停止後も維持されます。詳しくは、ダイアログとサイドバーに関するガイドをご覧ください。

https://developers.google.com/apps-script/reference/base/ui#alertprompt,-buttons

スプレッドシートのメッセージアラートにボタンを付与するGAS実行の様子

alert(prompt,buttons) メソッドを利用して、スプレッドシートのメッセージアラートにボタンを付与するGASを実行してみました。

alert(prompt,buttons)を実行することで、

  • ブラウザ上に独自のメッセージを表示してボタンを付与してYES/NOの値を取得する

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

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

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

スプレッドシートのメッセージアラートにボタンを付与するGAS

//--メッセージアラートにボタン付与する
    function alertbtn(){
      //SpreadsheetAppを起動してuiを操作
      let ui = SpreadsheetApp.getUi();
      //■ui.alert()にui.ButtonSet.YES_NOを設定してボタンを付与する
      let val = ui.alert("今の気分は?",ui.ButtonSet.YES_NO);
    
      //もしButton押下がYESなら
      if(val == ui.Button.YES){
        //人間の旨を掲載
        ui.alert("あなたは素晴らしい")
      //Button押下がNOなら
      }else{
        //天才の旨を掲載
        ui.alert("あなたは天才です");
      }
    }

alert(prompt,buttons)のパラメーター

名前説明
prompt Stringダイアログボックスに表示するメッセージ。
buttonsButtonSetダイアログボックスの表示を設定するボタン。
alert(prompt,buttons)のパラメーター

buttonsについてはEnum ButtonSetプロパティを参照↓

Enum ButtonSetのプロパティ

プロパティ種類説明
OKEnum1つの [OK] ボタン。閉じることができません。
OK_CANCELEnum「OK」ボタンと「キャンセル」ボタン。ユーザーは操作を続行または停止できます。
YES_NOEnum「はい」ボタンと「いいえ」ボタン。ユーザーは「はい」または「いいえ」で答えることができます。
YES_NO_CANCELEnum「はい」ボタン、「いいえ」ボタン、「キャンセル」ボタン。ユーザーは「はい/いいえ」と答えるか、操作を停止します。
Enum ButtonSetプロパティ

alert(prompt,buttons)の戻り値

Button - ユーザーがクリックしたボタン。

スプレッドシートのメッセージアラートにボタンを付与するまとめ

GAS×スプレッドシートのメッセージアラートにボタンを付与するならalert(prompt,buttons)メソッドを利用しましょう。

関連記事:【GAS】スプレッドシートの文字を折り返す

関連記事:【GAS】スプレッドシートの文字の折返しを配列で設定する

関連記事:【GAS】スプレッドシートの文字の折返し方法を設定する

関連記事:【GAS】スプレッドシートの文字を斜めにする

-メッセージを操作する