セルを操作する

【GAS】スプレッドシートの文字を折返し・はみ出し・切り詰めに設定する

GASでスプレッドシートの文字を折返し・はみ出し・切り詰めに設定するには「setWrapStrategy(strategy) 」を利用する。

setWrapStrategy(strategy)

範囲内のセルのテキストの折り返し方法を設定します。

https://developers.google.com/apps-script/reference/spreadsheet/range#setwrapstrategystrategy

スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するGAS実行の様子

setWrapStrategy(strategy) メソッドを利用して、スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するGASを実行してみました。

setWrapStrategy(strategy)を実行することで、

  • 任意セル範囲(1つ・または複数)に対し、文字を折返し・はみ出し・切り詰めいづれかを設定する

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

スプレッドシートでテキストの角度を設定する場合は、以下記事を御覧ください。

参照記事:【GAS】スプレッドシートの文字の角度を設定する

スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するGAS

function turnsettei(){
    //SpreadsheetAppを起動してシートをアクティブに
     let ss = SpreadsheetApp.getActiveSheet();
    //A1にテキストを設置してrangeに格納
     const range = ss.getRange("A1").setValue("SpreadSheet.Blue");
    //rangeにsetWrapStrategy(CLIP)で切り詰めを設定
     range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
     
    //YESNOでを設定
     const yesno = Browser.msgBox("テキストを折り返しますか",Browser.Buttons.YES_NO);
     
    //YESなら
       if(yesno == "yes"){
    //WRAPで折返しを設定
         range.setWrapStrategy(SpreadsheetApp.WrapStrategy.WRAP);
    //Noなら
       }else{
    //OVERFLOWでは見出しを設定
         range.setWrapStrategy(SpreadsheetApp.WrapStrategy.OVERFLOW);
       }
     }

setWrapStrategy(strategy)のパラメーター

名前説明
strategyWrapStrategy目的のラッピング戦略。以下「Enum WrapStrategyの詳細」を参考
setWrapStrategy(strategy)のパラメーター

Enum WrapStrategyの詳細

セルテキストの折り返しの処理に使用する戦略を列挙したものです。

プロパティ種類説明
WRAPEnum折返し:セル幅よりも長い行を改行します。1 行より長い単語は、文字レベルでラップされます。
OVERFLOWEnumはみ出し:そのセルが空である限り、次のセルへはみ出します。次のセルが空でない場合は、これは CLIP と同じように動作します。
CLIPEnum切り詰め:セル幅より長いクリップライン
setWrapStrategy(strategy)のパラメーター

setWrapStrategy(strategy)の戻り値

Range - チェーン用の範囲。

スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するまとめ

GAS×スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するならsetWrapStrategy(strategy) メソッドを利用しましょう。

関連記事:【GAS】スプレッドシートに数式を設定する

関連記事:【GAS】スプレッドシートで数式を複数設定する

関連記事:【GAS】スプレッドシートで数式をR1C1形式で設定する

関連記事:【GAS】スプレッドシートで数値・日付を指定した書式に設定する

-セルを操作する