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

Class Image

画像を表す PageElement。

メソッド

メソッド	戻り値の型	概要
`alignOnPage(alignmentPosition)`	`Image`	要素をページの指定された配置位置に配置します。
`bringForward()`	`Image`	ページ要素を 1 つ手前に移動します。
`bringToFront()`	`Image`	ページ要素をページの最前面に移動します。
`duplicate()`	`PageElement`	ページ要素を複製します。
`getAs(contentType)`	`Blob`	このオブジェクト内のデータを、指定されたコンテンツタイプに変換された blob として返します。
`getBlob()`	`Blob`	この画像内のデータを BLOB として返します。
`getBorder()`	`Border`	画像の `Border` を返します。
`getConnectionSites()`	`ConnectionSite[]`	ページ要素の `ConnectionSite` のリストを返します。ページ要素に接続サイトがない場合は、空のリストを返します。
`getContentUrl()`	`String`	画像への URL を取得します。
`getDescription()`	`String`	ページ要素の代替テキストの説明を返します。
`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 度は回転がないことを意味します。
`getSourceUrl()`	`String\|null`	画像のソース URL を取得します（利用可能な場合）。
`getTitle()`	`String`	ページ要素の代替テキストのタイトルを返します。
`getTop()`	`Number`	要素が回転していない場合、ページの左上隅から測定した要素の垂直位置をポイント単位で取得します。
`getTransform()`	`AffineTransform`	ページ要素の変換を返します。
`getWidth()`	`Number\|null`	要素の幅をポイント単位で返します。要素が回転していない場合、これは要素のバウンディングボックスの幅です。
`preconcatenateTransform(transform)`	`Image`	指定された変換をページ要素の既存の変換に事前連結します。
`remove()`	`void`	ページ要素を削除します。
`removeLink()`	`void`	`Link` を削除します。
`replace(blobSource)`	`Image`	この画像を `BlobSource` オブジェクトで記述された画像に置き換えます。
`replace(blobSource, crop)`	`Image`	この画像を `Image` オブジェクトで記述された画像に置き換えます。必要に応じて、画像を切り抜いて合わせます。
`replace(imageUrl)`	`Image`	この画像を、指定された URL からダウンロードした別の画像に置き換えます。
`replace(imageUrl, crop)`	`Image`	この画像を、指定された URL からダウンロードした別の画像に置き換えます。必要に応じて、画像を切り抜いて合わせます。
`scaleHeight(ratio)`	`Image`	指定された比率で要素の高さを拡大縮小します。
`scaleWidth(ratio)`	`Image`	要素の幅を指定された比率で拡大縮小します。
`select()`	`void`	アクティブなプレゼンテーションの `PageElement` のみを選択し、以前の選択をすべて削除します。
`select(replace)`	`void`	アクティブなプレゼンテーションで `PageElement` を選択します。
`sendBackward()`	`Image`	ページ要素を 1 つの要素分、ページ上で後方に移動します。
`sendToBack()`	`Image`	ページ要素をページの背面に移動します。
`setDescription(description)`	`Image`	ページ要素の代替テキストの説明を設定します。
`setHeight(height)`	`Image`	要素の高さ（ポイント単位）を設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
`setLeft(left)`	`Image`	要素が回転していない場合、ページの左上隅から測定した要素の水平位置をポイント単位で設定します。
`setLinkSlide(slideIndex)`	`Link`	スライドのゼロベースのインデックスを使用して、指定された `Slide` に `Link` を設定します。
`setLinkSlide(slide)`	`Link`	指定された `Slide` に `Link` を設定します。リンクは指定されたスライド ID によって設定されます。
`setLinkSlide(slidePosition)`	`Link`	スライドの相対位置を使用して、指定された `Slide` に `Link` を設定します。
`setLinkUrl(url)`	`Link`	`Link` を指定された空でない URL 文字列に設定します。
`setRotation(angle)`	`Image`	要素の中心を軸とした時計回りの回転角度を度単位で設定します。
`setTitle(title)`	`Image`	ページ要素の代替テキストのタイトルを設定します。
`setTop(top)`	`Image`	要素が回転していない場合、ページの左上隅から測定した要素の垂直位置をポイント単位で設定します。
`setTransform(transform)`	`Image`	指定された変換を使用して、ページ要素の変換を設定します。
`setWidth(width)`	`Image`	要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素のバウンディングボックスの幅です。

詳細なドキュメント

`alignOnPage(alignmentPosition)`

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

パラメータ

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

戻る

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

`bringForward()`

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

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

戻る

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

承認

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

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

`bringToFront()`

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

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

戻る

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

承認

このメソッドを使用するスクリプトには、次の 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

`getAs(contentType)`

このオブジェクト内のデータを、指定されたコンテンツタイプに変換された blob として返します。このメソッドは、ファイル名に適切な拡張子（例: 「myfile.pdf」）を追加します。ただし、最後のピリオドの後に続くファイル名の一部（存在する場合）は、置き換える必要がある既存の拡張子であると想定されます。その結果、「ShoppingList.12.25.2014」は「ShoppingList.12.25.pdf」になります。

コンバージョンの 1 日あたりの割り当てを確認するには、Google サービスの割り当てをご覧ください。新しく作成された Google Workspace ドメインには、一時的に厳しい割り当てが適用されることがあります。

パラメータ

名前	型	説明
`contentType`	`String`	変換先の MIME タイプ。ほとんどの BLOB では、`'application/pdf'` が唯一の有効なオプションです。BMP、GIF、JPEG、PNG 形式の画像の場合、`'image/bmp'`、`'image/gif'`、`'image/jpeg'`、`'image/png'` のいずれも有効です。Google ドキュメントの場合、`'text/markdown'` も有効です。

戻る

Blob - blob としてのデータ。

`getBlob()`

この画像内のデータを BLOB として返します。

戻る

Blob - 画像データ（blob 形式）。

`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

`getContentUrl()`

画像の URL を取得します。

この URL にはリクエスト元のアカウントがタグ付けされているため、URL を知っているユーザーは、事実上、元のリクエスト元として画像にアクセスできます。プレゼンテーションの共有設定が変更されると、画像にアクセスできなくなることがあります。返された URL は短期間で有効期限が切れます。

戻る

String

承認

このメソッドを使用するスクリプトには、次の 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

`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()`

プレースホルダ画像のインデックスを返します。同じページに 2 つ以上のプレースホルダ画像があり、それらが同じタイプである場合、それぞれに固有のインデックス値が割り当てられます。画像がプレースホルダでない場合は 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

`getSourceUrl()`

画像のソース URL を取得します（利用可能な場合）。

URL で画像が挿入された場合、画像の挿入時に指定された URL を返します。

戻る

String|null - 画像の URL。画像にソース URL がない場合は null。

承認

このメソッドを使用するスクリプトには、次の 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`	このページ要素の変換に事前連結する変換。

戻る

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

承認

このメソッドを使用するスクリプトには、次の 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();

`replace(blobSource)`

この画像を BlobSource オブジェクトで記述された画像に置き換えます。

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

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

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

パラメータ

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

戻る

Image - 置き換え後の Image。

承認

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

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

`replace(blobSource, crop)`

この画像を Image オブジェクトで記述された画像に置き換えます。必要に応じて、画像を切り抜いて合わせます。

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

パラメータ

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

戻る

Image - 置き換え後の Image。

承認

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

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

`replace(imageUrl)`

この画像を、指定された URL からダウンロードした別の画像に置き換えます。

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

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

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

パラメータ

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

戻る

Image - 置き換え後の Image。

承認

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

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

`replace(imageUrl, crop)`

この画像を、指定された URL からダウンロードした別の画像に置き換えます。必要に応じて、画像を切り抜いて合わせます。

指定する URL は 2 KB 以下にする必要があります。

パラメータ

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

戻る

Image - 置き換え後の Image。

承認

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

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

`scaleHeight(ratio)`

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

パラメータ

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

戻る

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

承認

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

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

`scaleWidth(ratio)`

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

パラメータ

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

戻る

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

承認

このメソッドを使用するスクリプトには、次の 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 つ後ろに移動します。

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

戻る

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

承認

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

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

`sendToBack()`

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

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

戻る

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

承認

このメソッドを使用するスクリプトには、次の 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`	代替テキストの説明を設定する文字列。

戻る

Image - このページ要素。

承認

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

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

`setHeight(height)`

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

パラメータ

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

戻る

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

承認

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

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

`setLeft(left)`

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

パラメータ

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

戻る

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

承認

このメソッドを使用するスクリプトには、次の 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`	設定する新しい時計回りの回転角度（度）。

戻る

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

承認

このメソッドを使用するスクリプトには、次の 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`	代替テキストのタイトルを設定する文字列。

戻る

Image - このページ要素。

承認

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

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

`setTop(top)`

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

パラメータ

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

戻る

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

承認

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

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

`setTransform(transform)`

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

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

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

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

パラメータ

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

戻る

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

承認

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

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

`setWidth(width)`

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

パラメータ

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

戻る

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

承認

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

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

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

メソッド

詳細なドキュメント

alignOnPage(alignmentPosition)

パラメータ

戻る

bringForward()

戻る

承認

bringToFront()

戻る

承認

duplicate()

戻る

承認

getAs(contentType)

パラメータ

戻る

getBlob()

戻る

getBorder()

戻る

承認

getConnectionSites()

戻る

承認

getContentUrl()

戻る

承認

getDescription()

戻る

承認

getHeight()

戻る

承認

getInherentHeight()

戻る

承認

getInherentWidth()

戻る

承認

getLeft()

戻る

承認

getLink()

戻る

承認

getObjectId()

戻る

承認

getPageElementType()

戻る

承認

getParentGroup()

戻る

承認

getParentPage()

戻る

承認

getParentPlaceholder()

戻る

承認

getPlaceholderIndex()

戻る

承認

getPlaceholderType()

戻る

承認

getRotation()

戻る

承認

getSourceUrl()

戻る

承認

getTitle()

戻る

承認

getTop()

戻る

承認

Class Image

`alignOnPage(alignmentPosition)`

`bringForward()`

`bringToFront()`

`duplicate()`

`getAs(contentType)`

`getBlob()`

`getBorder()`

`getConnectionSites()`

`getContentUrl()`

`getDescription()`

`getHeight()`

`getInherentHeight()`

`getInherentWidth()`

`getLeft()`

`getLink()`

`getObjectId()`

`getPageElementType()`

`getParentGroup()`

`getParentPage()`

`getParentPlaceholder()`

`getPlaceholderIndex()`

`getPlaceholderType()`

`getRotation()`

`getSourceUrl()`

`getTitle()`

`getTop()`

`getTransform()`

`getWidth()`

`preconcatenateTransform(transform)`

`remove()`

`removeLink()`

`replace(blobSource)`

`replace(blobSource, crop)`

`replace(imageUrl)`

`replace(imageUrl, crop)`

`scaleHeight(ratio)`

`scaleWidth(ratio)`

`select()`

`select(replace)`

`sendBackward()`

`sendToBack()`

`setDescription(description)`

`setHeight(height)`

`setLeft(left)`

`setLinkSlide(slideIndex)`

`setLinkSlide(slide)`

`setLinkSlide(slidePosition)`