ページ要素のサイズと位置

ページ要素のサイズと位置を取得して変更する方法は 2 つあります。

サイズと位置のゲッター関数とセッター関数を使用します。
固有のサイズを維持しながら、getTransform() 関数と setTransform() 関数を使用してアフィン変換を操作します。

ページ要素のプロパティを読み取る

サイズ変更と回転

図に示すように、サイズと位置は、回転がない場合のレンダリングされたページ要素のバウンディングボックスを基準に測定されます。

左と上: ページの左上隅から回転していない境界ボックスの左上隅までの距離。getLeft() と getTop() を使用して値を読み取ります。
幅と高さ: 回転していない境界ボックスの幅と高さ。getWidth() と getHeight() を使用して値を読み取ります。
回転: 境界ボックスの中心を軸として垂直線に対して時計回りに回転します。getRotation() を使用して値を読み取ります。

長さはすべてポイント（pt）単位で測定されます。回転は度（°）で測定されます。

ページ要素のプロパティを設定する

insertShape() などの挿入メソッドを使用してページ要素を作成するときに、そのサイズと位置を設定します。既存のシェイプについては、サイズ、位置、回転を設定できます。また、要素のスケーリングを設定して、サイズを変更したり、辺の 1 つに沿って反転させたりすることもできます。

作成時

ページ要素を作成するときに、位置とサイズに関する情報を提供します。

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.TEXT_BOX, 100, 200, 300, 60);
Logger.log('Left: ' + shape.getLeft() + 'pt; Top: '
                    + shape.getTop() + 'pt; Width: '
                    + shape.getWidth() + 'pt; Height: '
                    + shape.getHeight() + 'pt; Rotation: '
                    + shape.getRotation() + ' degrees.');

上記のスクリプトは、アクティブなプレゼンテーションの最初のスライドに、指定された位置とサイズで図形を作成し、図形の位置とサイズに関する情報を読み取ります。想定されるログは次のとおりです。

Left: 100pt; Top: 200pt; Width: 300pt; Height: 60pt; Rotation: 0 degrees.

サイズ、位置、回転

作成後にページ要素のサイズと位置を更新します。

setLeft() と setTop() を使用して、回転していないバウンディングボックスの左上隅の位置を設定します。
setWidth() と setHeight() を使用して、境界ボックスのレンダリングされた幅と高さを設定します。
setRotation() を使用して、バウンディングボックスの中心を中心とした時計回りの回転を設定します。

次のスクリプトは、アクティブなプレゼンテーションの最初のスライドに図形を作成し、セッターを使用してその位置、サイズ、回転を更新し、図形の位置とサイズ情報を読み取ります。

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
shape.setLeft(100).setTop(200).setWidth(50).setHeight(60).setRotation(90);
Logger.log('Left: ' + shape.getLeft()
                    + 'pt; Top: ' + shape.getTop()
                    + 'pt; Width: ' + shape.getWidth()
                    + 'pt; Height: ' + shape.getHeight()
                    + 'pt; Rotation: ' + shape.getRotation() + '\u00B0.');

想定されるログは次のとおりです。

Left: 100pt; Top: 200pt; Width: 50pt; Height: 60pt; Rotation: 90°.

サイズ、位置、回転の設定は、任意の順序または組み合わせで使用できます。上記のスクリプトの 3 行目を次のスクリプトに置き換えても、同じ結果が得られます。

shape.setWidth(55);
shape.setRotation(90).setHeight(60).setLeft(100);
shape.setWidth(50).setTop(200);

ページ要素を拡大縮小する

setWidth() と setHeight() を使用してシェイプのサイズを絶対値に設定する代わりに、scaleWidth() と scaleHeight() を使用して、相対的なスケーリング係数でページ要素を拡大または縮小できます。

shape.scaleHeight(0.5).scaleWidth(2);

次の図は、上記のコードが 45° 回転した正方形でどのように機能するかを示しています。境界ボックスの左上隅はスケーリング中に固定されます。

スライドのスケーリング

ページ要素を反転する

scaleWidth() と scaleHeight() の引数は負の値にすることができ、ページ要素を水平方向または垂直方向に反転させるために使用できます。

// Flip horizontally along the left edge of the bounding box.
shape.scaleWidth(-1);
// Flip vertically along the top edge of the bounding box.
shape.scaleHeight(-1);

次の図は、上記のコードが 45° 回転したシェイプでどのように動作するかを示しています。ページ要素は、バウンディングボックスの中心ではなく、バウンディングボックスのいずれかの辺に沿って反転します。

スライドの振り返り

線の回転

他のページ要素と同様に、線の回転は線の垂直角度ではなく、バウンディングボックスの回転です。開始点と終了点を指定して線を作成すると、その回転は常に 0° になります。スライドの UI で線の端点をドラッグすると、垂直方向の角度と、境界ボックスのサイズと位置は変わりますが、回転は変わりません。setRotation() を使用すると、線のバウンディングボックスが回転し、垂直方向の角度が効果的に変更されます。そのため、2 つの線が同じ視覚的な垂直角度を持っていても、バウンディングボックスが異なれば、サイズ、位置、回転の値も異なります。

制限事項

一部のサイズ設定と位置設定の方法は、一部の種類のページ要素と互換性がありません。次の表に、特定の種類のページ要素と互換性のないメソッドをまとめます。

メソッド	図形	動画	テーブル
getHeight(), getWidth()	✔	✔	NO（null を返す）
setHeight(), setWidth()	✔	✔	いいえ
setRotation()	✔	いいえ	いいえ
scaleHeight(), scaleWidth()	✔	✔	いいえ

ページ要素にせん断がある場合、すべてのサイズ設定と位置設定の方法で予期しない結果が生じる可能性があります。すべての制限は変更される可能性があります。最新情報については、リファレンスを確認してください。

アフィン変換を使用する

高度な制御を行うために、ページ要素のサイズと位置を、その固有（ネイティブ）のサイズとアフィン変換によって計算して調整することもできます。

Google Apps Script には、アフィン変換を使用するための Google スライド API と同様のインターフェースが用意されています。

プロパティを読み取るには、アフィン変換を使用できます。アフィン変換は、要素の拡大縮小、回転、せん断、配置の方法を記述します。要素の変換と固有（ネイティブ）サイズを使用してスライド上の視覚的なサイズを計算する方法については、変換をご覧ください。Apps Script では、次のように使用します。
- ページ要素の固有（ネイティブ）サイズ用の getInherentWidth() と getInherentHeight()。
- ページ要素のアフィン変換の getTransform()。
プロパティを変更するには、アフィン変換を使用して、スケーリング、回転、反射などを実行します。アフィン変換を使用してページ要素のサイズと位置を設定する方法については、サイズと位置をご覧ください。Apps Script では、次のコードを使用します。
- setTransform(): ページ要素のアフィン変換を設定します（ABSOLUTE モードと同様）。
- preconcatenateTransform() を使用して、アフィン変換をページ要素の現在の変換に事前連結します（RELATIVE モードと同様）。

次のスクリプトは、シェイプを作成し、その変換を設定し、固有のサイズを読み取り、アフィン変換を読み取ります。

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
shape.setTransform(SlidesApp.newAffineTransformBuilder()
                   .setScaleX(2)
                   .setScaleY(1)
                   .setTranslateX(100)
                   .setTranslateY(200)
                   .build());
Logger.log('Inherent width: ' + shape.getInherentWidth()
                              + 'pt; Inherent height: '
                              + shape.getInherentHeight() + 'pt.');

想定されるログ出力は次のとおりです。

Inherent width: 236.2pt; Inherent height: 236.2pt.

結果のシェイプには、次の変換、レンダリングされたサイズ、位置が設定されます。

AffineTransform{scaleX=2.0, scaleY=1.0, shearX=0.0, shearY=0.0, translateX=100.0, translateY=200.0}
Left: 100pt; Top: 200pt; Width: 472.4pt; Height: 236.2pt; Rotation: 0°.

ページ要素のサイズと位置 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。