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);
}
setRichTextValue(value)のパラメーター
名前 | 型 | 説明 |
---|---|---|
value | RichTextValue | 目的のリッチテキスト値。 |
setRichTextValue(value) の戻り値
Range - チェーン用の範囲。
スプレッドシートのテキストに装飾(リッチテキスト)値を設定するまとめ
GAS×スプレッドシートのテキストに装飾(リッチテキスト)値を設定するならsetRichTextValue(value)
メソッドを利用しましょう。