【GAS入門#67】スライドのテキスト入力と文字サイズ強調!TextRange.setText() と setFontSize() で「達成率120%」をダイナミックに装飾しよう

月次レポートや役員会用のプレゼン資料を作るとき、重要な実績値やトピックスの数字はパッと見て伝わるように大きく強調したいですよね。

前回(第66回)は、Googleスライド内にプログラムからテキストボックスを配置する Slide.insertTextBox() について解説しました。 しかし、箱(テキストボックス)を置いた枠組みだけでは資料として完成しません。中に具体的な報告文章を流し込み、「目標達成率120%」といった最重要キーワードの文字サイズをドカンと大きく拡大して視線を引きつける装飾を施してこそ、説得力のあるスライドに仕上がります。

そこで第67回となる今回は、スライド内のテキストを自在にコントロールする TextRange.setText() と TextRange.setFontSize() を徹底解説します!

「文字を挿入したら文字サイズが変わってしまった」「文章の中の特定フレーズだけを大きくしたいのに、ボックス全体が巨大化してしまう…」といった初心者特有のお悩みも一発で解決できるテクニックをお伝えします。

今回も札幌オフィスの月次業績報告プレゼンを舞台に、ハンズオン形式で分かりやすく紐解いていきましょう!

1. そもそも TextRange とは?テキスト操作の基本構造

GoogleスライドのGAS操作において、テキストの入出力や装飾を行うキーマンとなるのが TextRange(テキストレンジ) オブジェクトです。

スプレッドシートやGoogleドキュメントを学んできた方は、「セル(Range)」や「段落(Paragraph)」のようなものをイメージすると分かりやすいでしょう。

図形・テキストボックスと TextRange の関係

スライド上のテキストは、必ず「図形(Shape)」や「テキストボックス(TextBox)」という外側の枠(コンテナ)の中に存在します。

【Slide(スライド)】
   └── 【TextBox / Shape(枠組み)】
          └── 【TextRange(枠の中に入っている文字データ本体)】 ★ここに文字入力やサイズ変更を行う!

第66回で作成したテキストボックスから getText() という命令を呼び出すことで、枠の中にある TextRange を掴むことができます。

// 1. スライドにテキストボックスを配置(枠を作る)
var textBox = slide.insertTextBox("今月のトピックス");

// 2. 枠の中から文字操作用の「TextRange」を取り出す!
var textRange = textBox.getText();

2. 本日覚える2つの主要メソッド

今回メインでマスターするのは、この TextRange に対して呼び出す2つのメソッドです。

① TextRange.setText("表示したい文章")

指定した TextRange に文字列をセット(入力・置き換え)する命令です。

textRange.setText("札幌オフィスの今月売上は目標達成率120%を記録しました!");

② TextRange.setFontSize(ポイント数)

指定した TextRange の文字サイズ(フォントサイズ)を pt(ポイント)単位の数値で変更する命令です。

// 文字サイズを24ptに変更する
textRange.setFontSize(24);

3. STEP1:準備!「札幌オフィス月次業績レポート」プレゼンを用意しよう

それでは、実際に手を動かしながら学んでいきましょう! 第61回〜第66回で作成したスライド作成環境を活用します。

準備手順

  1. Googleドライブで新しい Googleスライド を作成します(または第61回で作成した「札幌オフィス月次業績レポートテンプレート」を開きます)。
  2. スライドのタイトルを 「札幌オフィス月次業績レポート」 に設定します。
  3. プレゼンファイルのID(URLの https://docs.google.com/presentation/d/【ここの文字列】/edit 部分)をコピーしておきます。
  4. 上部メニューの 「拡張機能」 > 「Apps Script」 をクリックしてエディタを開きます。

4. STEP2:【実践】トピックスの文章入力と全体サイズ変更(基本編)

まずは基本として、スライドにテキストボックスを作成し、文章を入力して全体を読みやすい18ptの文字サイズに設定してみましょう。

コードを入力する

GASのエディタ画面にあるコードを全消去し、以下のコードを貼り付けます(YOUR_PRESENTATION_ID の部分は、ご自身のスライドIDに書き換えてください)。

function setTopicsText() {
  // ① プレゼンテーションと最初のスライドを取得(第61回参照)
  var presentationId = "YOUR_PRESENTATION_ID";
  var presentation = SlidesApp.openById(presentationId);
  var slide = presentation.getSlides()[0];
  
  // ② トピックス用のテキストボックスをスライドの中央付近に配置(第66回参照)
  // insertTextBox(テキスト, 左位置, 上位置, 幅, 高さ)
  var textBox = slide.insertTextBox("", 50, 150, 600, 150);
  
  // ③ テキストボックスから TextRange オブジェクトを取得
  var textRange = textBox.getText();
  
  // ④ 文章を流し込み(setText)
  var reportText = "【今月のハイライト】\n札幌オフィスの新規プロジェクト受注により、全社目標に対する達成率120%を達成しました!";
  textRange.setText(reportText);
  
  // ⑤ 文字サイズを全体的に18ptに変更(setFontSize)
  textRange.setFontSize(18);
  
  Logger.log("トピックス文章のセットとサイズ変更が完了しました!");
}

保存と実行

  1. エディタ上部の 「保存(フロッピーマーク)」 をクリックします。
  2. 関数が setTopicsText になっていることを確認し、「実行」 をクリックします。
  3. スライド画面を確認すると、指定した座標に綺麗な文章が18ptで流し込まれているはずです!

5. STEP3:【応用】「達成率120%」の特定のフレーズだけを部分拡大・装飾!

基本編で文章を入力できましたが、プレゼン資料としてはもう少しメリハリが欲しいところですよね。

「達成率120%」という一番伝えたい数字だけを、36ptの巨大サイズ+太字 でアピールしてみましょう!

どうやって文章の一部だけを装飾するの?

「TextRange 全体に setFontSize(36) をかけると文章全部が巨大化してしまう…」とお悩みの方へ。

実は、TextRange.find("検索する文字") というメソッドを使うことで、文章の中の特定の文字部分だけをピンポイントで切り出した「サブTextRange」 を取得することができます!

// 全体のTextRangeの中から「達成率120%」という部分だけを探して掴む!
var matchedRanges = textRange.find("達成率120%");

// 見つかった部分(0番目)のサイズだけを36ptにする!
matchedRanges[0].setFontSize(36);

実践コード(部分強調バージョン)

以下の応用コードをエディタに追加して実行してみましょう。

function highlightPerformanceMetric() {
  var presentationId = "YOUR_PRESENTATION_ID";
  var slide = SlidesApp.openById(presentationId).getSlides()[0];
  
  // トピックスカード用テキストボックスを挿入
  var textBox = slide.insertTextBox("", 50, 100, 620, 200);
  var textRange = textBox.getText();
  
  // 報告文章をセット
  var content = "■ 札幌オフィス 業績トピックス\n今月は新規クライアント3社との契約が完了し、部署目標の「達成率120%」を無事記録しました。";
  textRange.setText(content);
  
  // ベースとなる全体のフォントサイズを16ptに統一
  textRange.setFontSize(16);
  
  // 【超重要テクニック】「達成率120%」の文字だけをピンポイント検索して装飾!
  var targetPhrase = "達成率120%";
  var matches = textRange.find(targetPhrase);
  
  // 該当する文字が見つかった場合の処理
  if (matches.length > 0) {
    var highlightRange = matches[0]; // 該当部分のTextRangeを取得
    
    // 文字サイズを36ptに拡大!
    highlightRange.setFontSize(36);
    
    // 太字にしてさらに強調(第10回の知識応用!)
    highlightRange.setBold(true);
    
    // 文字色を札幌の情熱カラー(鮮やかな赤/朱色)に変更
    highlightRange.setForegroundColor("#D32F2F");
  }
  
  Logger.log("「達成率120%」のダイナミック装飾が完了しました!");
}

実行結果の確認

スライド画面を開くと、文章全体は落ち着いた16ptで読みやすく整えられつつ、「達成率120%」の7文字だけが36ptの赤色・太字で飛び出すように強調表示されているはずです!

プロのデザイナーが作ったかのようなインパクトのある業績カードが、プログラム一発で生成できました。

6. 知っておくと得する!TextRange の便利プロパティ&関連メソッド一覧

テキスト装飾でよく使う TextRange の主要メソッドをまとめました。

メソッド名役割コード例
setText(text)全体テキストを書き換えるtextRange.setText("こんにちは")
setFontSize(pt)フォントサイズ(pt)を変更するtextRange.setFontSize(20)
setBold(boolean)太字にする / 解除するtextRange.setBold(true)
setForegroundColor(hex)文字の色を変更する(カラーコード)textRange.setForegroundColor("#1A73E8")
setFontFamily(font)フォントの種類を変更するtextRange.setFontFamily("Mplus 1p")
find(pattern)特定の文字列を検索して範囲を返すtextRange.find("検索文字")
clear()テキストボックス内の文字を全消去textRange.clear()

7. 初心者が絶対につ購入!5大トラップと完全解決策

スライドのテキスト操作で初心者が必ずハマる「5つの落とし穴」と解決策をまとめました。

トラップ1:shape.setText() と書いて TypeError になる

// ✕ エラーになる書き方
var textBox = slide.insertTextBox("テスト");
textBox.setText("新しい文章"); // TypeError: textBox.setText is not a function

【原因と解決策】

setText() や setFontSize() は、テキストボックス(Shape)が持っているメソッドではなく、内部の TextRange が持っているメソッドです。

必ず textBox.getText().setText("...") のように getText() を挟んで呼び出してください。

トラップ2:setText() を呼んだら、せっかく設定した文字装飾がリセットされた!

// ✕ 失敗する順番
textRange.setFontSize(36); // 先にサイズ変更
textRange.setText("新しい文章"); // あとから文字セット ➡ サイズが初期化されてしまう!

【原因と解決策】

setText() はテキスト全体を新しい文章で置き換える処理のため、過去に設定していた文字サイズや装飾設定がリセットされる仕様があります。

必ず 「1. setText() で文章を流し込む ➡ 2. setFontSize() で装飾する」 という順番を守りましょう!

トラップ3:setFontSize("24pt") と単位をつけてエラーになる

// ✕ 間違い
textRange.setFontSize("24pt"); // エラーになります

// ◯ 正解
textRange.setFontSize(24); // 数字のみ(数値型)を渡す

【原因と解決策】

setFontSize() に渡す引数は、pt などの単位文字列ではなく、純粋な 数値(Number) です。

トラップ4:find() の戻り値が「配列」であることを忘れてそのまま命令を呼ぶ

// ✕ エラーになる書き方
var match = textRange.find("達成率120%");
match.setFontSize(36); // TypeError: match.setFontSize is not a function

【原因と解決策】

find() は、該当する箇所が複数存在する可能性があるため、TextRange の「配列 []」 を返します。

1番目に見つかった箇所を装飾したい場合は、必ず match[0].setFontSize(36) のようにインデックス [0] を指定してください。

トラップ5:find() で見つからなかった時にプログラムがクラッシュする

万が一、検索したテキスト(例: “達成率120%”)が文章中に存在しなかった場合、matches は空の配列 [] になります。

その状態で matches[0].setFontSize(36) を実行すると、「matches[0] は存在しない(undefined)」となってエラーで止まってしまいます。

必ず if (matches.length > 0) { ... } という条件チェック(ガード節)を挟むのがプロの書き方です。

8. まとめ&次回予告

今回は、Googleスライド内のテキスト入力をコントロールする TextRange.setText() と、文字サイズを自由自在に変更する TextRange.setFontSize() を解説しました。

今日の重要ポイントおさらい

  1. スライドの文字操作は、textBox.getText() で TextRange を取得してから行う!
  2. setText("文章") ➡ setFontSize(数値) の順序で処理するのが鉄則!
  3. 特定部分だけを拡大したい時は textRange.find("フレーズ")[0] で部分取得する!
  4. 数字指定の setFontSize(36) に単位文字列(”pt”)はつけない!

これで、報告書やプレゼン資料の中で「一番伝えたい数値」を直感的にアピールできるようになりましたね!

さて、トピックスカードで定性的な成果をアピールできたら、次にスライドへ入れたくなるのは 「プロジェクトごとの売上やコスト推移を整理した表(テーブル)」 ですよね。

次回(第68回)は、スライド内に整然とした綺麗な表を自動生成する Slide.insertTable() を解説します!