画像を表す PageElement
。
Methods
メソッド | 戻り値の型 | 概要 |
---|---|---|
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 | 要素の高さ(ポイント単位)を取得します。これは、要素が回転していない場合の要素の境界ボックスの高さです。 |
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 度は回転していないことを意味します。 |
getSourceUrl() | String | 画像のソース URL を取得します(利用可能な場合)。 |
getTitle() | String | ページ要素の代替テキストのタイトルを返します。 |
getTop() | Number | 要素が回転していないときに、ページの左上隅から測定したポイント単位で要素の垂直位置を取得します。 |
getTransform() | AffineTransform | ページ要素の変換を返します。 |
getWidth() | Number | 要素の幅をポイント単位で返します。これは、要素が回転していない場合の要素の境界ボックスの幅です。 |
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 | スライドのゼロから始まるインデックスを使用して、Link を指定された Slide に設定します。 |
setLinkSlide(slide) | Link | Link を指定された Slide に設定します。リンクは指定されたスライド ID によって設定されます。 |
setLinkSlide(slidePosition) | Link | スライドの相対位置を使用して、Link を指定された Slide に設定します。 |
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()
bringToFront()
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' のいずれかも有効です。 |
リターン
Blob
- blob としてのデータ。
getBlob()
getBorder()
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()
ページ要素の代替テキストの説明を返します。description はタイトルと組み合わされ、代替テキストの表示と読み上げを行います。
リターン
String
- ページ要素の代替テキストの説明。
承認
この方法を使用するスクリプトには、次の 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
getLink()
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()
getParentPage()
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
getSourceUrl()
画像のソース URL を取得します(利用可能な場合)。
URL によって画像を挿入すると、画像の挿入時に提供された URL を返します。
リターン
String
- 画像の 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
。
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
preconcatenateTransform(transform)
指定された変換をページ要素の既存の変換に事前連結します。
newTransform = argument * existingTransform
たとえば、ページ要素を 36 ポイント左に移動するには:
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
を削除します。
shape.removeLink();
replace(blobSource)
この画像を、BlobSource
オブジェクトで記述される画像に置き換えます。
画像を挿入すると、
BlobSource
から画像が一度取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 50 MB 未満、25 メガピクセルを超えないようにしてください。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
画像のアスペクト比を維持するため、画像は既存の画像のサイズに合わせて拡大縮小され、中央に配置されます。
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); 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
オブジェクトで記述された画像に置き換えます。必要に応じて、画像が収まるように切り抜かれます。
画像を挿入すると、
BlobSource
から画像が一度取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 50 MB 未満、25 メガピクセルを超えないようにしてください。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // 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 から画像が取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 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 から画像が取得され、プレゼンテーション内に表示するためにコピーが保存されます。画像は 50 MB 未満、25 メガピクセルを超えないようにしてください。また、PNG、JPEG、GIF のいずれかの形式である必要があります。
指定する 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
に設定されます。
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var 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
パラメータを使用してページ要素を選択する際は、次の条件を満たす必要があります。
PageElement
オブジェクトの親Page
は、current page selection
である必要があります。- 複数の
Page
オブジェクトを選択しないでください。
これを確認するには、最初に Page.selectAsCurrentPage()
を使用して親 Page
を選択し、次にそのページのページ要素を選択することをおすすめします。
var 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. var pageElements = slide.getPageElements(); for (var 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()
sendToBack()
setDescription(description)
ページ要素の代替テキストの説明を設定します。
このメソッドは、Group
要素ではサポートされていません。
// Set the first page element's alt text description to "new alt text description". var 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)
setLinkSlide(slideIndex)
スライドのゼロから始まるインデックスを使用して、指定された Slide
に Link
を設定します。
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
パラメータ
名前 | 型 | 説明 |
---|---|---|
slideIndex | Integer | スライドのゼロから始まるインデックス。 |
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slide)
Link
を指定された Slide
に設定します。リンクは指定されたスライド ID で設定されます。
// Set a link to the first slide of the presentation. var slide = presentation.getSlides()[0]; shape.setLinkSlide(slide);
パラメータ
名前 | 型 | 説明 |
---|---|---|
slide | Slide | リンクする Slide 。 |
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slidePosition)
スライドの相対位置を使用して、Link
を指定された Slide
に設定します。
// Set a link to the first slide of the presentation. shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);
パラメータ
名前 | 型 | 説明 |
---|---|---|
slidePosition | SlidePosition | 相対 SlidePosition 。 |
リターン
承認
この方法を使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkUrl(url)
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". var 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)
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