GASでスプレッドシートの文字を折返し・はみ出し・切り詰めに設定するには「setWrapStrategy(strategy)
」を利用する。
setWrapStrategy(strategy)
範囲内のセルのテキストの折り返し方法を設定します。
https://developers.google.com/apps-script/reference/spreadsheet/range#setwrapstrategystrategy
スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するGAS実行の様子
setWrapStrategy(strategy) メソッドを利用して、スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するGASを実行してみました。
setWrapStrategy(strategy)を実行することで、
- 任意セル範囲(1つ・または複数)に対し、文字を折返し・はみ出し・切り詰めいづれかを設定する
といった操作が可能です。
スプレッドシートでテキストの角度を設定する場合は、以下記事を御覧ください。
スプレッドシートの文字を折返し・はみ出し・切り詰めに設定する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)のパラメーター
名前 | 型 | 説明 |
---|---|---|
strategy | WrapStrategy | 目的のラッピング戦略。以下「Enum WrapStrategyの詳細」を参考 |
Enum WrapStrategyの詳細
セルテキストの折り返しの処理に使用する戦略を列挙したものです。
プロパティ | 種類 | 説明 |
---|---|---|
WRAP | Enum | 折返し:セル幅よりも長い行を改行します。1 行より長い単語は、文字レベルでラップされます。 |
OVERFLOW | Enum | はみ出し:そのセルが空である限り、次のセルへはみ出します。次のセルが空でない場合は、これは CLIP と同じように動作します。 |
CLIP | Enum | 切り詰め:セル幅より長いクリップライン |
setWrapStrategy(strategy)の戻り値
Range - チェーン用の範囲。
スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するまとめ
GAS×スプレッドシートの文字を折返し・はみ出し・切り詰めに設定するならsetWrapStrategy(strategy)
メソッドを利用しましょう。