このページは Cloud Translation API によって翻訳されました。

Class Shape

より具体的な分類がない一般的な形状を表す PageElement。テキストボックス、長方形、その他の定義済み図形が含まれます。

メソッド

メソッド	戻り値の型	概要
`alignOnPage(alignmentPosition)`	`Shape`	要素をページの指定された配置位置に配置します。
`bringForward()`	`Shape`	ページ要素を 1 つ手前に移動します。
`bringToFront()`	`Shape`	ページ要素をページの最前面に移動します。
`duplicate()`	`PageElement`	ページ要素を複製します。
`getAutofit()`	`Autofit\|null`	この図形内のテキストの `Autofit` を返します。
`getBorder()`	`Border`	シェイプの `Border` を返します。
`getConnectionSites()`	`ConnectionSite[]`	ページ要素の `ConnectionSite` のリストを返します。ページ要素に接続サイトがない場合は、空のリストを返します。
`getContentAlignment()`	`ContentAlignment`	図形内のテキストの `ContentAlignment` を返します。
`getDescription()`	`String`	ページ要素の代替テキストの説明を返します。
`getFill()`	`Fill`	シェイプの `Fill` を返します。
`getHeight()`	`Number\|null`	要素の高さ（ポイント単位）を取得します。これは、要素に回転がない場合の要素のバウンディングボックスの高さです。
`getInherentHeight()`	`Number\|null`	要素の固有の高さをポイント単位で返します。
`getInherentWidth()`	`Number\|null`	要素の固有の幅をポイント単位で返します。
`getLeft()`	`Number`	要素が回転していない場合、ページの左上隅から測定された要素の水平位置をポイント単位で返します。
`getLink()`	`Link\|null`	リンクがない場合は `Link` または `null` を返します。
`getObjectId()`	`String`	このオブジェクトの一意の ID を返します。
`getPageElementType()`	`PageElementType`	ページ要素の型を `PageElementType` 列挙型で返します。
`getParentGroup()`	`Group\|null`	このページ要素が属するグループを返します。要素がグループに属していない場合は `null` を返します。
`getParentPage()`	`Page`	このページ要素があるページを返します。
`getParentPlaceholder()`	`PageElement\|null`	プレースホルダの親ページ要素を返します。
`getPlaceholderIndex()`	`Integer\|null`	シェイプのプレースホルダインデックスを返します。
`getPlaceholderType()`	`PlaceholderType`	シェイプのプレースホルダタイプを返します。シェイプがプレースホルダでない場合は `PlaceholderType.NONE` を返します。
`getRotation()`	`Number`	要素の中心を軸とした時計回りの回転角度を度数で返します。0 度は回転がないことを意味します。
`getShapeType()`	`ShapeType`	シェイプの型を返します。
`getText()`	`TextRange`	図形のテキストコンテンツを返します。
`getTitle()`	`String`	ページ要素の代替テキストのタイトルを返します。
`getTop()`	`Number`	要素が回転していない場合、ページの左上隅から測定した要素の垂直位置をポイント単位で取得します。
`getTransform()`	`AffineTransform`	ページ要素の変換を返します。
`getWidth()`	`Number\|null`	要素の幅をポイント単位で返します。要素が回転していない場合、これは要素のバウンディングボックスの幅です。
`preconcatenateTransform(transform)`	`Shape`	指定された変換をページ要素の既存の変換に事前連結します。
`remove()`	`void`	ページ要素を削除します。
`removeLink()`	`void`	`Link` を削除します。
`replaceWithImage(blobSource)`	`Image`	この図形を `BlobSource` が提供する画像に置き換えます。
`replaceWithImage(blobSource, crop)`	`Image`	この図形を `BlobSource` が提供する画像に置き換えます。
`replaceWithImage(imageUrl)`	`Image`	この図形を画像に置き換えます。
`replaceWithImage(imageUrl, crop)`	`Image`	この図形を画像に置き換えます。
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	この図形を Google スプレッドシートのグラフに置き換えます。
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	この図形を Google スプレッドシートのグラフの画像に置き換えます。
`scaleHeight(ratio)`	`Shape`	指定された比率で要素の高さを拡大縮小します。
`scaleWidth(ratio)`	`Shape`	要素の幅を指定された比率で拡大縮小します。
`select()`	`void`	アクティブなプレゼンテーションの `PageElement` のみを選択し、以前の選択をすべて削除します。
`select(replace)`	`void`	アクティブなプレゼンテーションで `PageElement` を選択します。
`sendBackward()`	`Shape`	ページ要素を 1 つの要素分、ページ上で後方に移動します。
`sendToBack()`	`Shape`	ページ要素をページの背面に移動します。
`setContentAlignment(contentAlignment)`	`Shape`	図形内のテキストの `ContentAlignment` を設定します。
`setDescription(description)`	`Shape`	ページ要素の代替テキストの説明を設定します。
`setHeight(height)`	`Shape`	要素の高さ（ポイント単位）を設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
`setLeft(left)`	`Shape`	要素が回転していない場合、ページの左上隅から測定した要素の水平位置をポイント単位で設定します。
`setLinkSlide(slideIndex)`	`Link`	スライドのゼロベースのインデックスを使用して、指定された `Slide` に `Link` を設定します。
`setLinkSlide(slide)`	`Link`	指定された `Slide` に `Link` を設定します。リンクは指定されたスライド ID によって設定されます。
`setLinkSlide(slidePosition)`	`Link`	スライドの相対位置を使用して、指定された `Slide` に `Link` を設定します。
`setLinkUrl(url)`	`Link`	`Link` を指定された空でない URL 文字列に設定します。
`setRotation(angle)`	`Shape`	要素の中心を軸とした時計回りの回転角度を度単位で設定します。
`setTitle(title)`	`Shape`	ページ要素の代替テキストのタイトルを設定します。
`setTop(top)`	`Shape`	要素が回転していない場合、ページの左上隅から測定した要素の垂直位置をポイント単位で設定します。
`setTransform(transform)`	`Shape`	指定された変換を使用して、ページ要素の変換を設定します。
`setWidth(width)`	`Shape`	要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素のバウンディングボックスの幅です。

詳細なドキュメント

`alignOnPage(alignmentPosition)`

要素をページの指定された配置位置に配置します。

パラメータ

名前	型	説明
`alignmentPosition`	`AlignmentPosition`	ページ上のこのページ要素を配置する位置。

戻る

Shape - チェーン用のこのページ要素。

`bringForward()`

ページ要素を 1 つの要素分、ページの手前に移動します。

ページ要素はグループに属していてはなりません。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`bringToFront()`

ページ要素をページの最前面に移動します。

ページ要素はグループに属していてはなりません。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`duplicate()`

ページ要素を複製します。

重複するページ要素は、元の要素と同じページに同じ位置に配置されます。

戻る

PageElement - このページ要素の新しい複製。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getAutofit()`

この図形内のテキストの Autofit を返します。シェイプでテキストが許可されていない場合は null。

戻る

Autofit|null - この図形内のテキストの自動調整。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getBorder()`

シェイプの Border を返します。

戻る

Border - このシェイプの枠線の設定。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getConnectionSites()`

ページ要素の ConnectionSite のリストを返します。ページ要素に接続サイトがない場合は、空のリストを返します。

戻る

ConnectionSite[] - 接続サイトのリスト。この要素に接続サイトがない場合は空になることがあります。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getContentAlignment()`

図形内のテキストの ContentAlignment を返します。

戻る

ContentAlignment - この図形内のテキストの配置。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getDescription()`

ページ要素の代替テキストの説明を返します。説明はタイトルと組み合わされて、代替テキストの表示と読み上げに使用されます。

戻る

String - ページ要素の代替テキストの説明。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getFill()`

シェイプの Fill を返します。

戻る

Fill - このシェイプの塗りつぶし設定。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getHeight()`

要素の高さ（ポイント単位）を取得します。これは、要素に回転がない場合の要素のバウンディングボックスの高さです。

この方法は、すべてのページ要素に対応しているわけではありません。このメソッドと互換性のないページ要素については、サイズと位置の制限事項をご覧ください。

戻る

Number|null - ページ要素の固有の高さ（ポイント単位）。ページ要素に高さがない場合は null。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentHeight()`

要素の固有の高さをポイント単位で返します。

ページ要素の変換は、その固有のサイズを基準としています。要素の最終的な外観を決定するには、要素の変換と組み合わせて固有のサイズを使用します。

戻る

Number|null - ページ要素の固有の高さ（ポイント単位）。ページ要素に高さがない場合は null。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentWidth()`

要素の固有の幅をポイント単位で返します。

戻る

Number|null - ページ要素の固有の幅（ポイント単位）。ページ要素に幅がない場合は null。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLeft()`

要素が回転していない場合、ページの左上隅から測定された要素の水平位置をポイント単位で返します。

戻る

Number - ページの左上隅からの、この要素の水平方向の位置（ポイント単位）。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLink()`

リンクがない場合は、Link または null を返します。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

戻る

Link|null - リンクがない場合は Link または null。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getObjectId()`

このオブジェクトの一意の ID を返します。ページとページ要素で使用されるオブジェクト ID は、同じ名前空間を共有します。

戻る

String - このオブジェクトの一意の ID。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElementType()`

ページ要素の型を PageElementType 列挙型で返します。

戻る

PageElementType - ページ要素のタイプ。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentGroup()`

このページ要素が属するグループを返します。要素がグループに属していない場合は null を返します。

戻る

Group|null - このページ要素が属するグループ、または null。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPage()`

このページ要素があるページを返します。

戻る

Page - この要素が存在するページ。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPlaceholder()`

プレースホルダの親ページ要素を返します。シェイプがプレースホルダでない場合、または親がない場合は、null を返します。

戻る

PageElement|null - この図形のプレースホルダの親ページ要素。この図形がプレースホルダでない場合や、親がない場合は null。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderIndex()`

シェイプのプレースホルダインデックスを返します。同じページに同じプレースホルダタイプのインスタンスが複数ある場合、それぞれに固有のインデックス値が割り当てられます。シェイプがプレースホルダでない場合は null を返します。

戻る

Integer|null - このシェイプのプレースホルダインデックス。シェイプがプレースホルダでない場合は null。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderType()`

シェイプのプレースホルダタイプを返します。シェイプがプレースホルダでない場合は PlaceholderType.NONE を返します。

戻る

PlaceholderType - このシェイプのプレースホルダタイプ。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRotation()`

要素の中心を軸とした時計回りの回転角度を度数で返します。0 度は回転がないことを意味します。

戻る

Number - 0 以上 360 未満の回転角度（度単位）。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getShapeType()`

シェイプの型を返します。

戻る

ShapeType - このシェイプのタイプ。

`getText()`

シェイプのテキストコンテンツを返します。

図形内のテキストは常に改行文字で終わります。

戻る

TextRange - この図形のテキストコンテンツ。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTitle()`

ページ要素の代替テキストのタイトルを返します。タイトルは説明と組み合わされて、代替テキストの表示と読み上げに使用されます。

戻る

String - ページ要素の代替テキストのタイトル。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTop()`

要素が回転していない場合、ページの左上隅から測定した要素の垂直位置をポイント単位で取得します。

戻る

Number - ページの左上隅からの、この要素の垂直方向の位置（ポイント単位）。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTransform()`

ページ要素の変換を返します。

ページ要素の視覚的な外観は、絶対変換によって決まります。絶対変換を計算するには、ページ要素の変換をそのすべての親グループの変換と事前連結します。ページ要素がグループに属していない場合、その絶対変換はこのフィールドの値と同じになります。

戻る

AffineTransform - ページ要素の変換。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getWidth()`

要素の幅をポイント単位で返します。これは、要素に回転がない場合の要素のバウンディングボックスの幅です。

戻る

Number|null - ページ要素の固有の幅（ポイント単位）。ページ要素に幅がない場合は null。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`preconcatenateTransform(transform)`

指定された変換をページ要素の既存の変換に事前連結します。

newTransform = argument * existingTransform;

たとえば、ページ要素を左に 36 ポイント移動するには:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

ページ要素の変換を setTransform(transform) に置き換えることもできます。

パラメータ

名前	型	説明
`transform`	`AffineTransform`	このページ要素の変換に事前連結する変換。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`remove()`

ページ要素を削除します。

削除オペレーションの後、Group にページ要素が 1 つも含まれていない場合、グループ自体も削除されます。

マスターまたはレイアウトでプレースホルダ PageElement を削除すると、空の継承プレースホルダも削除されます。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`removeLink()`

Link を削除します。

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replaceWithImage(blobSource)`

このシェイプを BlobSource が提供する画像に置き換えます。

画像は、挿入時に指定された BlobSource から一度だけ取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像のサイズは 50 MB 未満、2,500 万ピクセル以下で、PNG、JPEG、GIF のいずれかの形式である必要があります。

画像のアスペクト比を維持するため、画像は既存の図形のサイズに合わせて拡大縮小され、中央に配置されます。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
shape.replaceWithImage(driveImage);

パラメータ

名前	型	説明
`blobSource`	`BlobSource`	画像データ。

戻る

Image - 図形を置き換えた Image。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithImage(blobSource, crop)`

このシェイプを BlobSource が提供する画像に置き換えます。

画像を挿入すると、BlobSource から画像が 1 回取得され、プレゼンテーション内に表示するためのコピーが保存されます。画像のサイズは 50 MB 未満、2,500 万ピクセル以下で、PNG、JPEG、GIF のいずれかの形式である必要があります。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

パラメータ

名前	型	説明
`blobSource`	`BlobSource`	画像データ。
`crop`	`Boolean`	`true` の場合、既存の図形のサイズに合わせて画像を切り抜きます。それ以外の場合、画像は拡大縮小され、中央に配置されます。

戻る

Image - 図形を置き換えた Image。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithImage(imageUrl)`

この図形を画像に置き換えます。

画像を挿入すると、URL から画像が 1 回取得され、プレゼンテーション内で表示するためにコピーが保存されます。画像は 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。

指定された URL は一般公開されており、2 KB 以下である必要があります。URL 自体は画像とともに保存され、Image.getSourceUrl() を介して公開されます。

画像のアスペクト比を維持するため、既存の図形のサイズを基準に画像のサイズが調整され、中央に配置されます。

パラメータ

名前	型	説明
`imageUrl`	`String`	画像をダウンロードする画像の URL。

戻る

Image - 図形を置き換えた Image。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithImage(imageUrl, crop)`

この図形を画像に置き換えます。

指定する URL は 2 KB 以下にする必要があります。URL 自体は画像とともに保存され、Image.getSourceUrl() を介して公開されます。

パラメータ

名前	型	説明
`imageUrl`	`String`	画像をダウンロードする画像の URL。
`crop`	`Boolean`	`true` の場合、既存の図形のサイズに合わせて画像を切り抜きます。それ以外の場合、画像は拡大縮小され、中央に配置されます。

戻る

Image - 図形を置き換えた Image。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithSheetsChart(sourceChart)`

この図形を Google スプレッドシートのグラフに置き換えます。

グラフは、更新可能な参照元の Google スプレッドシートのグラフにリンクされています。他の共同編集者には、元のスプレッドシートへのリンクが表示されます。

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

パラメータ

名前	型	説明
`sourceChart`	`EmbeddedChart`	図形を置き換えるスプレッドシートのグラフ。

戻る

SheetsChart - 図形を置き換えたグラフ。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replaceWithSheetsChartAsImage(sourceChart)`

この図形を Google スプレッドシートのグラフの画像に置き換えます。

Google スプレッドシートのグラフのアスペクト比を維持するため、グラフの画像は既存のシェイプのサイズに合わせて拡大縮小され、中央に配置されます。

グラフの画像は、参照元の Google スプレッドシートのグラフにリンクされていません。

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

パラメータ

名前	型	説明
`sourceChart`	`EmbeddedChart`	図形を置き換えるスプレッドシートのグラフ。

戻る

Image - 図形を置き換えたグラフの画像。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleHeight(ratio)`

指定された比率で要素の高さを拡大縮小します。要素の高さは、要素に回転がない場合のバウンディングボックスの高さです。

パラメータ

名前	型	説明
`ratio`	`Number`	このページ要素の高さをスケーリングする比率。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleWidth(ratio)`

要素の幅を指定された比率で拡大縮小します。要素の幅は、要素が回転していない場合のバウンディングボックスの幅です。

パラメータ

名前	型	説明
`ratio`	`Number`	このページ要素の幅をスケーリングする比率。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

アクティブなプレゼンテーションの PageElement のみを選択し、以前の選択をすべて削除します。これは、true を指定して select(replace) を呼び出すのと同じです。

スクリプトがプレゼンテーションにバインドされている場合にのみ、スクリプトを実行しているユーザーの選択にアクセスできます。

これにより、PageElement の親 Page が current page selection として設定されます。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select(replace)`

アクティブなプレゼンテーションで PageElement を選択します。

スクリプトがプレゼンテーションにバインドされている場合にのみ、スクリプトを実行しているユーザーの選択にアクセスできます。

このメソッドに true を渡すと、PageElement のみが選択され、以前の選択がすべて削除されます。また、PageElement の親 Page を current page selection として設定します。

複数の PageElement オブジェクトを選択するには、false を渡します。PageElement オブジェクトは同じ Page に存在する必要があります。

false パラメータを使用してページ要素を選択する際は、次の条件を満たす必要があります。

PageElement オブジェクトの親 Page は current page selection である必要があります。
複数の Page オブジェクトが選択されていないようにする必要があります。

これを確実にするには、まず Page.selectAsCurrentPage() を使用して親 Page を選択し、次にそのページのページ要素を選択することをおすすめします。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

パラメータ

名前	型	説明
`replace`	`Boolean`	`true` の場合、選択内容は以前の選択内容を置き換えます。それ以外の場合、選択内容は以前の選択内容に追加されます。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendBackward()`

ページ要素をページ上で 1 つ後ろに移動します。

ページ要素はグループに属していてはなりません。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendToBack()`

ページ要素をページの背面に送信します。

ページ要素はグループに属していてはなりません。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setContentAlignment(contentAlignment)`

図形のテキストの ContentAlignment を設定します。

このメソッドは、更新された図形のテキスト自動調整プロパティを自動的に無効にします。

パラメータ

名前	型	説明
`contentAlignment`	`ContentAlignment`	設定する配置。

戻る

Shape - チェーン用のこのシェイプ。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setDescription(description)`

ページ要素の代替テキストの説明を設定します。

このメソッドは Group 要素ではサポートされていません。

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

パラメータ

名前	型	説明
`description`	`String`	代替テキストの説明を設定する文字列。

戻る

Shape - このページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setHeight(height)`

要素の高さ（ポイント単位）を設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。

パラメータ

名前	型	説明
`height`	`Number`	このページ要素の新しい高さをポイント単位で設定します。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLeft(left)`

要素が回転していない場合、ページの左上隅から測定した要素の水平位置をポイント単位で設定します。

パラメータ

名前	型	説明
`left`	`Number`	設定する新しい水平位置（ポイント単位）。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slideIndex)`

スライドのゼロベースのインデックスを使用して、指定された Slide に Link を設定します。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

パラメータ

名前	型	説明
`slideIndex`	`Integer`	スライドのゼロから始まるインデックス。

戻る

Link - 設定された Link。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slide)`

指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

パラメータ

名前	型	説明
`slide`	`Slide`	リンクする `Slide`。

戻る

Link - 設定された Link。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slidePosition)`

スライドの相対位置を使用して、指定された Slide に Link を設定します。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

パラメータ

名前	型	説明
`slidePosition`	`SlidePosition`	相対的な `SlidePosition`。

戻る

Link - 設定された Link。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkUrl(url)`

Link を指定された空でない URL 文字列に設定します。

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

パラメータ

名前	型	説明
`url`	`String`	URL 文字列。

戻る

Link - 設定された Link。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setRotation(angle)`

要素の中心を軸とした時計回りの回転角度を度単位で設定します。

パラメータ

名前	型	説明
`angle`	`Number`	設定する新しい時計回りの回転角度（度）。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTitle(title)`

ページ要素の代替テキストのタイトルを設定します。

このメソッドは Group 要素ではサポートされていません。

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

パラメータ

名前	型	説明
`title`	`String`	代替テキストのタイトルを設定する文字列。

戻る

Shape - このページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTop(top)`

要素が回転していない場合、ページの左上隅から測定した要素の垂直位置をポイント単位で設定します。

パラメータ

名前	型	説明
`top`	`Number`	設定する新しい垂直位置（ポイント単位）。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTransform(transform)`

指定された変換を使用して、ページ要素の変換を設定します。

グループの変換を更新すると、そのグループ内のページ要素の絶対変換が変更され、外観が変わる可能性があります。

グループ内のページ要素の変換を更新しても、そのページ要素の変換のみが変更され、グループの変換やグループ内の他のページ要素の変換には影響しません。

変換がページ要素の視覚的な外観に与える影響について詳しくは、getTransform() をご覧ください。

パラメータ

名前	型	説明
`transform`	`AffineTransform`	このページ要素に設定されている変換。

戻る

Shape - チェーン用のこの要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setWidth(width)`

要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素のバウンディングボックスの幅です。

パラメータ

名前	型	説明
`width`	`Number`	このページ要素の新しい幅（ポイント単位）。

戻る

Shape - チェーン用のこのページ要素。

承認

このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

Class Shape コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

メソッド

詳細なドキュメント

alignOnPage(alignmentPosition)

パラメータ

戻る

bringForward()

戻る

承認

bringToFront()

戻る

承認

duplicate()

戻る

承認

getAutofit()

戻る

承認

getBorder()

戻る

承認

getConnectionSites()

戻る

承認

getContentAlignment()

戻る

承認

getDescription()

戻る

承認

getFill()

戻る

承認

getHeight()

戻る

承認

getInherentHeight()

戻る

承認

getInherentWidth()

戻る

承認

getLeft()

戻る

承認

getLink()

戻る

承認

getObjectId()

戻る

承認

getPageElementType()

戻る

承認

getParentGroup()

戻る

承認

getParentPage()

戻る

承認

getParentPlaceholder()

戻る

承認

getPlaceholderIndex()

戻る

承認

getPlaceholderType()

戻る

承認

getRotation()

戻る

承認

getShapeType()

戻る

getText()

戻る

承認

getTitle()

戻る

承認

Class Shape

`alignOnPage(alignmentPosition)`

`bringForward()`

`bringToFront()`

`duplicate()`

`getAutofit()`

`getBorder()`

`getConnectionSites()`

`getContentAlignment()`

`getDescription()`

`getFill()`

`getHeight()`

`getInherentHeight()`

`getInherentWidth()`

`getLeft()`

`getLink()`

`getObjectId()`

`getPageElementType()`

`getParentGroup()`

`getParentPage()`

`getParentPlaceholder()`

`getPlaceholderIndex()`

`getPlaceholderType()`

`getRotation()`

`getShapeType()`

`getText()`

`getTitle()`

`getTop()`

`getTransform()`

`getWidth()`

`preconcatenateTransform(transform)`

`remove()`

`removeLink()`

`replaceWithImage(blobSource)`

`replaceWithImage(blobSource, crop)`

`replaceWithImage(imageUrl)`

`replaceWithImage(imageUrl, crop)`

`replaceWithSheetsChart(sourceChart)`

`replaceWithSheetsChartAsImage(sourceChart)`

`scaleHeight(ratio)`

`scaleWidth(ratio)`

`select()`

`select(replace)`

`sendBackward()`

`sendToBack()`

`setContentAlignment(contentAlignment)`

`setDescription(description)`

`setHeight(height)`