Google Apps Script（GAS）のgetTextRotations()メソッド、みんな使ったことある？これ、スプレッドシートのセル内のテキストの回転設定を取得するための便利な機能ばい。今回はこのメソッドがどんなものか、どう活用できるか、さらに応用事例を交えながら解説していくけん、ぜひ参考にしてみてくれよ。
getTextRotations()メソッドとは？
まず、getTextRotations()メソッドって、スプレッドシートのセルのテキストの回転設定を取得するためのものなんよ。このメソッドを使うと、指定したセル範囲内のすべてのテキスト回転角度や縦書き設定を効率よく確認できるばい。
例えば、スプレッドシートのセル内に縦書きや斜めに回転した文字があるとき、その回転角度や状態を取得することができるんよ。これがわかれば、後でそのデータを使って処理を変更したり、レイアウトを調整したりできるんじゃけ。
基本の使い方
const rotations = range.getTextRotations();
このコードで、指定した範囲range内のテキスト回転設定を取得できるんよ。戻り値は、回転角度や縦書きの状態を含む二次元配列じゃ。
例：特定範囲の回転情報をコンソールに出力
function fetchTextRotations() {
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('シート1');
const range = sheet.getRange('B2:C3');
const rotations = range.getTextRotations();
rotations.forEach((row, rowIndex) => {
row.forEach((cellRotation, colIndex) => {
console.log(`セル[${rowIndex+2},${colIndex+2}] 角度: ${cellRotation.getDegrees()}°, 縦書き: ${cellRotation.isVertical()}`);
});
});
}
このコードでは、B2:C3の範囲を対象に回転角度と縦書きかどうかを確認して、コンソールに表示しとるけ。これを参考にすれば、自分のスプレッドシートでも簡単に回転設定をチェックできるけ。
応用事例：実践的な活用方法
1. テキスト長に応じた動的回転調整
たとえば、セル内の文字数が多いときに自動でテキストの回転角度を調整することができるんよ。
function adjustTextRotationDynamically() {
const sheet = SpreadsheetApp.getActiveSheet();
const dataRange = sheet.getDataRange();
const rotations = dataRange.getTextRotations();
rotations.forEach((row, i) => {
row.forEach((rotation, j) => {
const cell = dataRange.getCell(i+1, j+1);
const textLength = cell.getValue().toString().length;
const newRotation = textLength > 15 ? 45 : 0;
if (rotation.getDegrees() !== newRotation) {
cell.setTextRotation(newRotation);
}
});
});
}
これで、文字数が15文字を超えたセルに対して自動で回転角度を変更することができるんじゃけ、デザイン的にも美しくなるばい。
2. 複数シート間での回転設定同期
複数のシートにわたって同じ回転設定を使いたい場合にも役立つんよ。
function synchronizeRotationsAcrossSheets() {
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sourceSheet = ss.getSheetByName('テンプレート');
const targetSheet = ss.getSheetByName('レポート');
const sourceRotations = sourceSheet.getRange('A1:D10').getTextRotations();
targetSheet.getRange('A1:D10').setTextRotations(sourceRotations);
}
これで、テンプレートシートの回転設定をレポートシートに一括で適用できるんよ。
パフォーマンスを最適化するために
大量のデータを扱うときは、効率的に処理を行うための工夫が必要じゃけ。たとえば、10,000セル以上の範囲を扱う場合、メモリ管理を工夫して効率よくデータを処理することが重要じゃよ。
function processLargeRangeEfficiently() {
const sheet = SpreadsheetApp.getActiveSheet();
const maxRows = sheet.getMaxRows();
const batchSize = 500;
for (let i = 0; i < maxRows; i += batchSize) {
const range = sheet.getRange(i + 1, 1, batchSize, sheet.getMaxColumns());
const rotations = range.getTextRotations();
rotations.forEach((row, rowIdx) => {
row.forEach((rotation, colIdx) => {
if (rotation.isVertical()) {
range.getCell(rowIdx + 1, colIdx + 1).setHorizontalAlignment('center');
}
});
});
Utilities.sleep(200); // API制限回避
}
}
こうすることで、APIコールの制限を避けながら大規模な範囲を効率的に処理できるんよ。
最後に
getTextRotations()メソッドを使えば、スプレッドシートのデータを見た目から管理するのがぐっと楽になるんよ。回転角度や縦書きの設定をプログラムで簡単に取得できるので、レイアウトの調整やデータ処理がスムーズになるばい。ちょっとした工夫で、見た目を大きく改善できるので、ぜひ活用してみてな！
コメント