Class Shape

シェイプ

より具体的な分類がない汎用的な形状を表す PageElement。テキスト ボックス、長方形、その他の事前定義された図形が含まれます。

メソッド

メソッド戻り値の型概要
alignOnPage(alignmentPosition)Shapeページ上の指定された位置に要素を配置します。
bringForward()Shapeページ要素を 1 つ前方に移動します。
bringToFront()Shapeページ要素をページの最前面に移動します。
duplicate()PageElementページ要素を複製します。
getAutofit()Autofitこのシェイプ内のテキストの Autofit を返します。
getBorder()Borderシェイプの Border を返します。
getConnectionSites()ConnectionSite[]ページ要素の ConnectionSite のリスト、またはページ要素に接続サイトがない場合は空のリストを返します。
getContentAlignment()ContentAlignment図形内のテキストの ContentAlignment を返します。
getDescription()Stringページ要素の代替テキストの説明を返します。
getFill()Fillシェイプの Fill を返します。
getHeight()Number要素の高さをポイント単位で取得します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
getInherentHeight()Number要素固有の高さをポイント単位で返します。
getInherentWidth()Number要素の固有の幅をポイント単位で返します。
getLeft()Number要素の水平位置をピクセル単位で返します。要素が回転していない場合は、ページの左上隅から測定されます。
getLink()Linkリンクがない場合、Link または null を返します。
getObjectId()Stringこのオブジェクトの一意の ID を返します。
getPageElementType()PageElementTypeページ要素のタイプを PageElementType 列挙型で返します。
getParentGroup()Groupこのページ要素が属するグループを返します。要素がグループに属していない場合は null を返します。
getParentPage()Pageこのページ要素が配置されているページを返します。
getParentPlaceholder()PageElementプレースホルダの親ページ要素を返します。
getPlaceholderIndex()Integerシェイプのプレースホルダ インデックスを返します。
getPlaceholderType()PlaceholderTypeシェイプのプレースホルダ タイプを返します。シェイプがプレースホルダでない場合は PlaceholderType.NONE を返します。
getRotation()Number要素の中心を中心とした時計回りの回転角度を度数で返します。0 度は回転なしを意味します。
getShapeType()ShapeTypeシェイプのタイプを返します。
getText()TextRange図形のテキスト コンテンツを返します。
getTitle()Stringページ要素の代替テキストのタイトルを返します。
getTop()Number要素の垂直位置をポイント単位で取得します。要素が回転していない場合は、ページの左上隅から測定されます。
getTransform()AffineTransformページ要素の変換を返します。
getWidth()Number要素の幅をポイント単位で返します。これは、要素が回転していない場合の要素の境界ボックスの幅です。
preconcatenateTransform(transform)Shape指定された変換をページ要素の既存の変換に事前に連結します。
remove()voidページ要素を削除します。
removeLink()voidLink を削除します。
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スライドのゼロベースのインデックスを使用して、Link を指定された Slide に設定します。
setLinkSlide(slide)Link指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。
setLinkSlide(slidePosition)Linkスライドの相対位置を使用して、指定された Slide に Link を設定します。
setLinkUrl(url)Link指定された空でない URL 文字列に Link を設定します。
setRotation(angle)Shape要素の中心を中心として時計回りに回転する角度を度単位で設定します。
setTitle(title)Shapeページ要素の代替テキストのタイトルを設定します。
setTop(top)Shape要素の垂直位置をポイント単位で設定します。要素が回転していない場合は、ページの左上隅から測定されます。
setTransform(transform)Shape指定された変換でページ要素の変換を設定します。
setWidth(width)Shape要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの幅です。

詳細なドキュメント

alignOnPage(alignmentPosition)

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

パラメータ

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

戻る

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 - この図形内のテキストの自動調整。

承認

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

承認

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

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

getInherentHeight()

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

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

戻る

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

承認

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

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

getInherentWidth()

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

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

戻る

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

リンクがない場合、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 - 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）。

承認

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

承認

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

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

getPlaceholderIndex()

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

戻る

Integer - このシェイプのプレースホルダ インデックス。シェイプがプレースホルダでない場合、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 です。

承認

このメソッドを使用するスクリプトには、次のスコープの 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) に置き換えることもできます。

パラメータ

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

戻る

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

Link を削除します。

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

replaceWithImage(blobSource)

このシェイプを BlobSource によって提供される画像に置き換えます。

画像は、挿入時に指定された BlobSource から 1 回取得され、コピーが保存されてプレゼンテーション内に表示されます。画像のサイズは 50 MB 未満で、25 MP を超えてはなりません。また、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);

パラメータ

名前型説明
blobSourceBlobSource画像データ。

戻る

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

承認

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

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

replaceWithImage(blobSource, crop)

このシェイプを BlobSource によって提供される画像に置き換えます。

画像を挿入すると、BlobSource から 1 回取得され、プレゼンテーション内に表示するためのコピーが保存されます。画像のサイズは 50 MB 未満で、25 メガピクセル以下である必要があります。また、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);

パラメータ

名前型説明
blobSourceBlobSource画像データ。
cropBooleantrue の場合、既存のシェイプのサイズに合わせて画像を切り抜きます。それ以外の場合、画像は拡大され、中央に配置されます。

戻る

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() を介して公開されます。

画像のアスペクト比を維持するため、画像は既存のシェイプのサイズに合わせてスケーリングされ、中央に配置されます。

パラメータ

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

戻る

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

承認

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

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

replaceWithImage(imageUrl, crop)

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

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

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

パラメータ

名前型説明
imageUrlString画像をダウンロードする画像 URL。
cropBooleantrue の場合、既存のシェイプのサイズに合わせて画像を切り抜きます。それ以外の場合、画像は拡大され、中央に配置されます。

戻る

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);

パラメータ

名前型説明
sourceChartEmbeddedChart図形に代わるスプレッドシート内のグラフ。

戻る

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);

パラメータ

名前型説明
sourceChartEmbeddedChart図形に代わるスプレッドシート内のグラフ。

戻る

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

承認

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

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

scaleHeight(ratio)

指定された比率で要素の高さをスケーリングします。要素の高さは、要素が回転していない場合の境界ボックスの高さです。

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

パラメータ

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

戻る

Shape - このページ要素（連結用）。

承認

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

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

scaleWidth(ratio)

要素の幅を指定された比率でスケーリングします。要素の幅は、要素が回転していない場合の境界ボックスの幅です。

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

パラメータ

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

戻る

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 として設定されます。

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

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

  1. PageElement オブジェクトの親 Page は current page selection である必要があります。
  2. 複数の 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);
}

パラメータ

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

承認

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

この方法では、更新されたシェイプのテキスト自動調整プロパティが自動的に無効になります。

パラメータ

名前型説明
contentAlignmentContentAlignment設定する配置。

戻る

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

パラメータ

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

戻る

Shape - このページの要素。

承認

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

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

setHeight(height)

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

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

パラメータ

名前型説明
heightNumber設定するこのページ要素の新しい高さ（ポイント単位）。

戻る

Shape - このページ要素（連結用）。

承認

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

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

setLeft(left)

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

パラメータ

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

戻る

Shape - このページ要素（連結用）。

承認

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

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

setLinkSlide(slideIndex)

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

// 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);

パラメータ

名前型説明
slideIndexIntegerスライドのゼロベースのインデックス。

戻る

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]);

パラメータ

名前型説明
slideSlideリンクする 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);

パラメータ

名前型説明
slidePositionSlidePosition相対的な SlidePosition。

戻る

Link - 設定された Link。

承認

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

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

setLinkUrl(url)

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

// 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');

パラメータ

名前型説明
urlStringURL 文字列。

戻る

Link - 設定された Link。

承認

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

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

setRotation(angle)

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

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

パラメータ

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

戻る

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

パラメータ

名前型説明
titleString代替テキストのタイトルに設定する文字列。

戻る

Shape - このページの要素。

承認

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

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

setTop(top)

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

パラメータ

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

戻る

Shape - このページ要素（連結用）。

承認

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

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

setTransform(transform)

指定された変換でページ要素の変換を設定します。

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

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

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

パラメータ

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

戻る

Shape - チェーン用の要素。

承認

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

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

setWidth(width)

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

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

パラメータ

名前型説明
widthNumber設定するこのページ要素の新しい幅（ポイント単位）。

戻る

Shape - このページ要素（連結用）。

承認

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

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