【GAS】スプレッドシートのテキストに装飾(リッチテキスト)値を設定する

GASでスプレッドシートのテキストに装飾(リッチテキスト)値を設定するには「setRichTextValue(value)」を利用する。

setRichTextValue(value)
範囲内のセルのリッチテキスト値を設定します。
https://developers.google.com/apps-script/reference/spreadsheet/range#setrichtextvaluevalue

スプレッドシートのテキストに装飾(リッチテキスト)値を設定するGAS実行の様子

setRichTextValue(value) メソッドを利用して、スプレッドシートのテキストに装飾(リッチテキスト)値を設定するGASを実行してみました。

setRichTextValue(value)を実行することで、

前もって装飾する設定を決め打ちして、変数へ格納しておく

といった操作が可能です。複数範囲に、同じ書式を設定する際に重宝するメソッドと言えるでしょう。

スプレッドシートの文字装飾のみをクリアする場合は、以下記事を御覧ください。

参照記事：【GAS】スプレッドシートの文字装飾のみをクリアする

スプレッドシートのテキストに装飾(リッチテキスト)値を設定するGAS

function richtext(){
  //SpreadsheeAppを起動してアクティブシートを取得
  let ss = SpreadsheetApp.getActiveSheet();
  //変数startへ入力ボックスの値を格納
  const start = Browser.inputBox("任意のセルを入力して下さい（A1形式）",Browser.Buttons.YES_NO);
  //変数rngにstartを格納
  const rng = ss.getRange(start);
  //変数textに文言を格納
  const text = "Spreadsheet.Blue";
　
　//アクティブシートの値をクリアしてrngにtextを設置
  ss.clear();
  rng.setValue(text);

　//newTextStyleでboldの書式を設定
  const bold = SpreadsheetApp.newTextStyle()
    .setFontSize(22)
    .setBold(true)
    .setBold(true)
    .build();

  //newTextStyleでitalicの書式を設定
  const italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .setStrikethrough(true)
    .build();

  //newTextStyleでstyleの書式を設定
  const style = SpreadsheetApp.newTextStyle()
    .setFontSize(20)
    .setForegroundColor('blue')
    .setBold(true)
    .build();
　
　//newRichTextValueでrichtextを設定
  const richtext = SpreadsheetApp.newRichTextValue()
    .setText(text)　　　　　　　 //textを設置
    .setTextStyle(0,6,bold)　　//0~6文字目にboldを適用
    .setTextStyle(6,11,italic) //6~11文字目にitalicを適用
    .setTextStyle(12,16,style) //12~16文字目にstyleを適用
    .build();

　//範囲rngにsetRichTextValueでrichtextを適用
  rng
    .setRichTextValue(richtext);
}