Форматирование текста в ячейке. RichText
Для автоматизации создания более выразительных отчетов в Таблицах Гугл было бы здорово использовать возможности форматирования не только ячейки, но и текста в ней. В посте рассматриваются варианты форматирования текста целиком и частей текста с использованием класса RichTextValue.
Метод setRichTextValue()
Объект класса Range имеет метод setRichTextValue(), который позволяет изменить цвет, размер, шрифт части текста ячейки.
Принцип его работы заключается в том, чтобы создать уже форматированный текст и заменить им содержимое диапазона.
Таким образом следует помнить, что использование этого метода влечет за собой полное изменение содержимого ячейки.
Создание RichTextValue
Чтобы создать RichTextValue, необходимо вызвать специальный конструктор RichTextBuilder
var richTextBuilder = SpreadsheetApp.newRichTextValue();
Следующим шагом следует передать этому конструктору сам текст и стиль
richTextBuilder.setText('Форматирование текста в ячейке. RichText');
richTextBuilder.setTextStyle(textStyle);
Чтобы получить эекземпляр класса, вызывается метод build()
var richText = richTextBuilder.build();
Создание TextStyle
Для генерации стиля также требуется использовать конструктор. На этот раз TextStyleBuilder.
Ниже создается стиль для придания тексту красного цвета
var textStyleBuilder = SpreadsheetApp.newTextStyle();
textStyleBuilder.setForegroundColor('red');
var textStyle = textStyleBuilder.build();