より具体的な分類がない汎用的な形状を表す Page
。テキスト ボックス、長方形、その他の事前定義された図形が含まれます。
メソッド
メソッド | 戻り値の型 | 概要 |
---|---|---|
align | Shape | ページ上の指定された位置に要素を配置します。 |
bring | Shape | ページ要素を 1 つ前方に移動します。 |
bring | Shape | ページ要素をページの最前面に移動します。 |
duplicate() | Page | ページ要素を複製します。 |
get | Autofit | このシェイプ内のテキストの Autofit を返します。 |
get | Border | シェイプの Border を返します。 |
get | Connection | ページ要素の Connection のリスト、またはページ要素に接続サイトがない場合は空のリストを返します。 |
get | Content | シェイプ内のテキストの Content を返します。 |
get | String | ページ要素の代替テキストの説明を返します。 |
get | Fill | シェイプの Fill を返します。 |
get | Number | 要素の高さをポイント単位で取得します。これは、要素が回転していない場合の要素の境界ボックスの高さです。 |
get | Number | 要素固有の高さをポイント単位で返します。 |
get | Number | 要素の固有の幅をポイント単位で返します。 |
get | Number | 要素の水平位置をピクセル単位で返します。要素が回転していない場合は、ページの左上隅から測定されます。 |
get | Link | リンクがない場合、Link または null を返します。 |
get | String | このオブジェクトの一意の ID を返します。 |
get | Page | ページ要素のタイプを Page 列挙型で返します。 |
get | Group | このページ要素が属するグループを返します。要素がグループに属していない場合は null を返します。 |
get | Page | このページ要素が配置されているページを返します。 |
get | Page | プレースホルダの親ページ要素を返します。 |
get | Integer | シェイプのプレースホルダ インデックスを返します。 |
get | Placeholder | シェイプのプレースホルダ タイプを返します。シェイプがプレースホルダでない場合は Placeholder を返します。 |
get | Number | 要素の中心を中心とした時計回りの回転角度を度数で返します。0 度は回転なしを意味します。 |
get | Shape | シェイプのタイプを返します。 |
get | Text | 図形のテキスト コンテンツを返します。 |
get | String | ページ要素の代替テキストのタイトルを返します。 |
get | Number | 要素の垂直位置をポイント単位で取得します。要素が回転していない場合は、ページの左上隅から測定されます。 |
get | Affine | ページ要素の変換を返します。 |
get | Number | 要素の幅をポイント単位で返します。これは、要素が回転していない場合の要素の境界ボックスの幅です。 |
preconcatenate | Shape | 指定された変換をページ要素の既存の変換に事前に連結します。 |
remove() | void | ページ要素を削除します。 |
remove | void | Link を削除します。 |
replace | Image | このシェイプを Blob によって提供される画像に置き換えます。 |
replace | Image | このシェイプを Blob によって提供される画像に置き換えます。 |
replace | Image | この図形を画像に置き換えます。 |
replace | Image | この図形を画像に置き換えます。 |
replace | Sheets | この図形を Google スプレッドシートのグラフに置き換えます。 |
replace | Image | この図形を Google スプレッドシートのグラフの画像に置き換えます。 |
scale | Shape | 指定された比率で要素の高さをスケーリングします。 |
scale | Shape | 要素の幅を指定された比率でスケーリングします。 |
select() | void | アクティブなプレゼンテーション内の Page のみを選択し、以前の選択内容をすべて削除します。 |
select(replace) | void | アクティブなプレゼンテーションの Page を選択します。 |
send | Shape | ページ要素をページ上で 1 つ後方に移動します。 |
send | Shape | ページ要素をページの一番後ろに移動します。 |
set | Shape | シェイプ内のテキストの Content を設定します。 |
set | Shape | ページ要素の代替テキストの説明を設定します。 |
set | Shape | 要素の高さをポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。 |
set | Shape | 要素の水平位置をポイント単位で設定します。要素が回転していない場合は、ページの左上隅から測定されます。 |
set | Link | スライドのゼロベースのインデックスを使用して、Link を指定された Slide に設定します。 |
set | Link | 指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。 |
set | Link | スライドの相対位置を使用して、指定された Slide に Link を設定します。 |
set | Link | 指定された空でない URL 文字列に Link を設定します。 |
set | Shape | 要素の中心を中心として時計回りに回転する角度を度単位で設定します。 |
set | Shape | ページ要素の代替テキストのタイトルを設定します。 |
set | Shape | 要素の垂直位置をポイント単位で設定します。要素が回転していない場合は、ページの左上隅から測定されます。 |
set | Shape | 指定された変換でページ要素の変換を設定します。 |
set | Shape | 要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの幅です。 |
詳細なドキュメント
align On Page(alignmentPosition)
ページ上の指定された位置に要素を配置します。
パラメータ
名前 | 型 | 説明 |
---|---|---|
alignment | Alignment | このページ要素をページ上で配置する位置。 |
戻る
Shape
- このページ要素(連結用)。
bring Forward()
bring To Front()
duplicate()
ページ要素を複製します。
重複するページ要素は、元のページ要素と同じ位置に配置されます。
戻る
Page
- このページ要素の新しい重複。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Autofit()
get Border()
get Connection Sites()
ページ要素の Connection
のリスト、またはページ要素に接続サイトがない場合は空のリストを返します。
戻る
Connection
- 接続サイトのリスト。この要素に接続サイトがない場合、空になることがあります。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Content Alignment()
シェイプ内のテキストの Content
を返します。
戻る
Content
- この図形内のテキストの配置。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Description()
ページ要素の代替テキストの説明を返します。説明はタイトルと組み合わせて、代替テキストとして表示および読み上げられます。
戻る
String
- ページ要素の代替テキストの説明。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Fill()
get Height()
要素の高さをポイント単位で取得します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
この方法は、すべてのページ要素に対応しているわけではありません。この方法に対応していないページ要素については、 サイズと配置の制限事項をご覧ください。
戻る
Number
- ページ要素固有の高さ(ポイント単位)。ページ要素に高さがない場合は null
です。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Inherent Height()
要素固有の高さをポイント単位で返します。
ページ要素の変換は、その固有のサイズを基準としています。要素の変換と組み合わせて固有のサイズを使用して、要素の最終的な外観を決定します。
戻る
Number
- ページ要素固有の高さ(ポイント単位)。ページ要素に高さがない場合は null
です。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Inherent Width()
要素の固有の幅をポイント単位で返します。
ページ要素の変換は、その固有のサイズを基準としています。要素の変換と組み合わせて固有のサイズを使用して、要素の最終的な外観を決定します。
戻る
Number
- ページ要素固有の幅(ポイント単位)。ページ要素に幅がない場合は null
です。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Left()
要素の水平位置をピクセル単位で返します。要素が回転していない場合は、ページの左上隅から測定されます。
戻る
Number
- この要素の水平位置(ページの左上からのピクセル単位)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Link()
リンクがない場合、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()}`); }
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Object Id()
このオブジェクトの一意の ID を返します。ページとページ要素で使用されるオブジェクト ID は同じ名前空間を共有します。
戻る
String
- このオブジェクトの一意の ID。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element Type()
ページ要素のタイプを Page
列挙型で返します。
戻る
Page
- ページ要素のタイプ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Parent Group()
get Parent Page()
get Parent Placeholder()
プレースホルダの親ページ要素を返します。シェイプがプレースホルダでないか、親がない場合は null
を返します。
戻る
Page
- このシェイプ プレースホルダの親ページ要素。このシェイプがプレースホルダでないか、親がない場合は null
。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder Index()
シェイプのプレースホルダ インデックスを返します。同じプレースホルダ タイプのインスタンスが同じページに複数存在する場合、それぞれに固有のインデックス値が割り当てられます。シェイプがプレースホルダでない場合、null
を返します。
戻る
Integer
- このシェイプのプレースホルダ インデックス。シェイプがプレースホルダでない場合、null
です。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder Type()
シェイプのプレースホルダ タイプを返します。シェイプがプレースホルダでない場合は Placeholder
を返します。
戻る
Placeholder
- このシェイプのプレースホルダ タイプ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Rotation()
要素の中心を中心とした時計回りの回転角度を度数で返します。0 度は回転なしを意味します。
戻る
Number
- 回転角度(0 ~ 360 度)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Shape Type()
get Text()
get Title()
ページ要素の代替テキストのタイトルを返します。タイトルは説明と組み合わせて、代替テキストを表示および読み上げるために使用されます。
戻る
String
- ページ要素の代替テキストのタイトル。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Top()
要素の垂直位置をポイント単位で取得します。要素が回転していない場合は、ページの左上隅から測定されます。
戻る
Number
- この要素の垂直位置(ページの左上から)。単位はポイントです。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Transform()
ページ要素の変換を返します。
ページ要素の視覚的な外観は、その絶対変換によって決まります。絶対変換を計算するには、ページ要素の変換を、そのすべての親グループの変換と事前に連結します。ページ要素がグループにない場合、その絶対変換は、このフィールドの値と同じです。
戻る
Affine
- ページ要素の変換。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Width()
要素の幅をポイント単位で返します。これは、要素が回転していない場合の要素の境界ボックスの幅です。
この方法は、すべてのページ要素に対応しているわけではありません。この方法に対応していないページ要素については、 サイズと配置の制限事項をご覧ください。
戻る
Number
- ページ要素固有の幅(ポイント単位)。ページ要素に幅がない場合は null
です。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenate Transform(transform)
指定された変換を、ページ要素の既存の変換に事前に連結します。
newTransform = argument * existingTransform;
たとえば、ページ要素を 36 ポイント左に移動するには、次のようにします。
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
ページ要素の変換を set
に置き換えることもできます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
transform | Affine | このページ要素の変換に事前に連結する変換。 |
戻る
Shape
- このページ要素(連結用)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
ページ要素を削除します。
削除オペレーション後に Group
にページ要素が 1 つしか含まれていない場合、またはページ要素が含まれていない場合は、グループ自体も削除されます。
マスターまたはレイアウトでプレースホルダ Page
が削除されると、空の継承プレースホルダも削除されます。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove Link()
Link
を削除します。
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
replace With Image(blobSource)
このシェイプを Blob
によって提供される画像に置き換えます。
画像は、挿入時に指定された Blob
から 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
blob | Blob | 画像データ。 |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace With Image(blobSource, crop)
このシェイプを Blob
によって提供される画像に置き換えます。
画像を挿入すると、Blob
から 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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
blob | Blob | 画像データ。 |
crop | Boolean | true の場合、既存のシェイプのサイズに合わせて画像を切り抜きます。それ以外の場合、画像は拡大され、中央に配置されます。 |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace With Image(imageUrl)
この図形を画像に置き換えます。
画像を挿入すると、その画像が URL から 1 回取得され、プレゼンテーション内に表示するためのコピーが保存されます。画像のサイズは 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
指定する URL は一般公開されているもので、2 KB 以下である必要があります。URL 自体は画像とともに保存され、Image.getSourceUrl()
を介して公開されます。
画像のアスペクト比を維持するため、画像は既存のシェイプのサイズに合わせてスケーリングされ、中央に配置されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
image | String | 画像をダウンロードする画像 URL。 |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace With Image(imageUrl, crop)
この図形を画像に置き換えます。
画像を挿入すると、その画像が URL から 1 回取得され、プレゼンテーション内に表示するためのコピーが保存されます。画像のサイズは 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
指定する URL は 2 KB 以下にする必要があります。URL 自体は画像とともに保存され、Image.getSourceUrl()
を介して公開されます。
パラメータ
名前 | 型 | 説明 |
---|---|---|
image | String | 画像をダウンロードする画像 URL。 |
crop | Boolean | true の場合、既存のシェイプのサイズに合わせて画像を切り抜きます。それ以外の場合、画像は拡大され、中央に配置されます。 |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace With Sheets Chart(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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
source | Embedded | 図形に代わるスプレッドシート内のグラフ。 |
戻る
Sheets
- 図形に置き換えられたグラフ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace With Sheets Chart As Image(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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
source | Embedded | 図形に代わるスプレッドシート内のグラフ。 |
戻る
Image
- 図形に置き換えられたグラフの画像。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scale Height(ratio)
指定された比率で要素の高さをスケーリングします。要素の高さは、要素が回転していない場合の境界ボックスの高さです。
この方法は、すべてのページ要素に対応しているわけではありません。この方法に対応していないページ要素については、 サイズと配置の制限事項をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
ratio | Number | このページ要素の高さをスケーリングする比率。 |
戻る
Shape
- このページ要素(連結用)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scale Width(ratio)
要素の幅を指定された比率でスケーリングします。要素の幅は、要素が回転していない場合の境界ボックスの幅です。
この方法は、すべてのページ要素に対応しているわけではありません。この方法に対応していないページ要素については、 サイズと配置の制限事項をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
ratio | Number | このページ要素の幅をスケーリングする比率。 |
戻る
Shape
- このページ要素(連結用)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
select()
アクティブなプレゼンテーション内の Page
のみを選択し、以前の選択内容をすべて削除します。これは、true
で select(replace)
を呼び出す場合と同じです。
スクリプトは、スクリプトを実行しているユーザーの選択にのみアクセスできます。ただし、スクリプトがプレゼンテーションにバインドされている場合に限られます。
これにより、Page
の親 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)
アクティブなプレゼンテーションの Page
を選択します。
スクリプトは、スクリプトを実行しているユーザーの選択にのみアクセスできます。ただし、スクリプトがプレゼンテーションにバインドされている場合に限られます。
このメソッドに true
を渡して、Page
のみを選択し、以前の選択をすべて削除します。また、Page
の親 Page
が current page selection
として設定されます。
false
を渡して、複数の Page
オブジェクトを選択します。Page
オブジェクトは同じ Page
に存在する必要があります。
false
パラメータを使用してページ要素を選択する際は、次の条件を満たしている必要があります。
Page
オブジェクトの親Element 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
send Backward()
send To Back()
set Content Alignment(contentAlignment)
シェイプ内のテキストの Content
を設定します。
この方法では、更新されたシェイプのテキスト自動調整プロパティが自動的に無効になります。
パラメータ
名前 | 型 | 説明 |
---|---|---|
content | Content | 設定する配置。 |
戻る
Shape
- チェーン用のこのシェイプ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Description(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
set Height(height)
要素の高さをポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
この方法は、すべてのページ要素に対応しているわけではありません。この方法に対応していないページ要素については、 サイズと配置の制限事項をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
height | Number | 設定するこのページ要素の新しい高さ(ポイント単位)。 |
戻る
Shape
- このページ要素(連結用)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Left(left)
set Link Slide(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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
slide | Integer | スライドのゼロベースのインデックス。 |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Slide(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 。 |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Slide(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);
パラメータ
名前 | 型 | 説明 |
---|---|---|
slide | Slide | 相対的な Slide 。 |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Url(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');
パラメータ
名前 | 型 | 説明 |
---|---|---|
url | String | URL 文字列。 |
戻る
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Rotation(angle)
要素の中心を中心とした時計回りの回転角度を度単位で設定します。
この方法は、すべてのページ要素に対応しているわけではありません。この方法に対応していないページ要素については、 サイズと配置の制限事項をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
angle | Number | 設定する新しい時計回りの回転角度(度)。 |
戻る
Shape
- このページ要素(連結用)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Title(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
set Top(top)
set Transform(transform)
指定された変換でページ要素の変換を設定します。
グループの変換を更新すると、そのグループ内のページ要素の絶対変換が変更され、外観が変化する可能性があります。
グループ内のページ要素の変換を更新しても、そのページ要素の変換のみが変更され、グループの変換やグループ内の他のページ要素の変換には影響しません。
変換がページ要素の外観に与える影響の詳細については、get
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
transform | Affine | このページ要素に設定されている変換。 |
戻る
Shape
- チェーン用の要素。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Width(width)
要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの幅です。
この方法は、すべてのページ要素に対応しているわけではありません。この方法に対応していないページ要素については、 サイズと配置の制限事項をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
width | Number | 設定するこのページ要素の新しい幅(ポイント単位)。 |
戻る
Shape
- このページ要素(連結用)。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations