表示图片的 Page
。
方法
方法 | 返回类型 | 简介 |
---|---|---|
align | Image | 将元素对齐到页面上的指定对齐位置。 |
bring | Image | 将页面元素在页面上向前移动一个元素。 |
bring | Image | 将页面元素移至页面顶部。 |
duplicate() | Page | 复制页面元素。 |
get | Blob | 将此对象内的数据作为转换为指定内容类型的 blob 返回。 |
get | Blob | 将此图片中的数据作为 blob 返回。 |
get | Border | 返回图片的 Border 。 |
get | Connection | 返回页面元素上的 Connection 列表,如果页面元素没有任何连接网站,则返回空列表。 |
get | String | 获取图片的网址。 |
get | String | 返回网页元素的替代文本说明。 |
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 | String | 获取图片的来源网址(如果有)。 |
get | String | 返回网页元素的替代文本标题。 |
get | Number | 获取元素的垂直位置(以像素为单位),从页面左上角测量,前提是元素未旋转。 |
get | Affine | 返回页面元素的转换。 |
get | Number | 返回元素的宽度(以像素为单位),即元素未旋转时的边界框宽度。 |
preconcatenate | Image | 将提供的转换预连接到页面元素的现有转换。 |
remove() | void | 移除页面元素。 |
remove | void | 移除 Link 。 |
replace(blobSource) | Image | 将此图片替换为由 Blob 对象描述的图片。 |
replace(blobSource, crop) | Image | 将此图片替换为由 Image 对象描述的图片,并可选择剪裁图片以适应大小。 |
replace(imageUrl) | Image | 将此图片替换为从所提供网址下载的另一张图片。 |
replace(imageUrl, crop) | Image | 将此图片替换为从所提供网址下载的另一张图片,并可选择剪裁图片以适应大小。 |
scale | Image | 根据指定的比例缩放元素的高度。 |
scale | Image | 按指定的比例缩放元素的宽度。 |
select() | void | 仅选择当前演示文稿中的 Page ,并移除之前的所有选择。 |
select(replace) | void | 选择有效演示文稿中的 Page 。 |
send | Image | 将页面元素在页面上向后移动一个元素。 |
send | Image | 将页面元素发送到页面底部。 |
set | Image | 设置页面元素的替代文本说明。 |
set | Image | 设置元素的高度(以点为单位),即元素未旋转时的元素边界框的高度。 |
set | Image | 设置元素的水平位置(以点为单位),从元素未旋转时页面左上角测量。 |
set | Link | 使用幻灯片的从零开始的索引将 Link 设置为指定的 Slide 。 |
set | Link | 将 Link 设置为给定的 Slide ,链接由给定的幻灯片 ID 设置。 |
set | Link | 使用滑块的相对位置将 Link 设置为给定 Slide 。 |
set | Link | 将 Link 设置为给定的非空网址字符串。 |
set | Image | 设置元素围绕其中心顺时针旋转的角度(以度为单位)。 |
set | Image | 设置网页元素的替代文本标题。 |
set | Image | 设置元素的垂直位置(以点为单位),从页面左上角(当元素未旋转时)测量。 |
set | Image | 使用提供的转换设置页面元素的转换。 |
set | Image | 设置元素的宽度(以点为单位),即元素未旋转时元素边界框的宽度。 |
详细文档
align On Page(alignmentPosition)
将元素对齐到页面上的指定对齐位置。
参数
名称 | 类型 | 说明 |
---|---|---|
alignment | Alignment | 此页面元素在页面上的对齐位置。 |
返回
Image
- 此页面元素,用于链式调用。
bring Forward()
bring To Front()
duplicate()
复制了页面元素。
重复的页面元素位于同一页面上与原始元素相同的位置。
返回
Page
- 此网页元素的新重复项。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get As(contentType)
将此对象内的数据作为转换为指定内容类型的 blob 返回。此方法会向文件名添加相应的扩展名,例如“myfile.pdf”。不过,它假定文件名最后一个英文句点(如果有)后面的部分是应替换的现有扩展名。因此,“ShoppingList.12.25.2014”会变为“ShoppingList.12.25.pdf”。
如需查看转化每日配额,请参阅 Google 服务的配额。新创建的 Google Workspace 网域可能会暂时受到更严格的配额限制。
参数
名称 | 类型 | 说明 |
---|---|---|
content | String | 要转换到的 MIME 类型。对于大多数 blob,'application/pdf' 是唯一有效的选项。对于 BMP、GIF、JPEG 或 PNG 格式的图片,'image/bmp' 、'image/gif' 、'image/jpeg' 或 'image/png' 中的任何一种也有效。对于 Google 文档,'text/markdown' 也有效。 |
返回
Blob
- 数据(以 blob 的形式)。
get Blob()
get Border()
get Connection Sites()
返回页面元素上的 Connection
列表,如果页面元素没有任何连接网站,则返回空列表。
返回
Connection
- 连接点列表,如果此元素没有连接点,则此列表可能为空。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Content Url()
获取图片的网址。
此网址会标记为请求者的账号,因此知道此网址的任何人都可以有效地以原始请求者的身份访问图片。如果演示文稿的共享设置发生变化,您可能会失去对图片的访问权限。返回的网址会在短时间后过期。
返回
String
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Description()
返回网页元素的替代文本说明。说明会与标题组合,以显示和朗读替代文本。
返回
String
- 网页元素的替代文本说明。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Height()
获取元素的高度(以像素为单位),即元素未旋转时的元素边界框的高度。
此方法不适用于所有页面元素。如需了解哪些页面元素不支持此方法,请参阅 调整大小和位置限制。
返回
Number
- 页面元素的固有高度(以点为单位),如果页面元素没有高度,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Inherent Height()
返回元素的固有高度(以点为单位)。
页面元素的转换与其固有大小相关。将固有尺寸与元素的转换结合使用,以确定元素的最终视觉外观。
返回
Number
- 页面元素的固有高度(以点为单位),如果页面元素没有高度,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Inherent Width()
返回元素的固有宽度(以点为单位)。
页面元素的转换与其固有大小相关。将固有尺寸与元素的转换结合使用,以确定元素的最终视觉外观。
返回
Number
- 页面元素固有的宽度(以点为单位),如果页面元素没有宽度,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Left()
返回元素的水平位置(以点为单位),从页面左上角(当元素未旋转时)测量。
返回
Number
- 此元素相对于页面左上角的水平位置(以像素为单位)。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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()}`); }
返回
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Object Id()
返回此对象的唯一 ID。页面和页面元素使用的对象 ID 共用相同的命名空间。
返回
String
- 此对象的唯一 ID。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Page Element Type()
返回页面元素的类型,表示为 Page
枚举。
返回
Page
- 页面元素的类型。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder Index()
返回占位符图片的索引。如果同一页面上的两个或更多占位符图片属于同一类型,则它们各有唯一的索引值。如果图片不是占位符,则返回 null
。
返回
Integer
- 此图片的占位符索引;如果此图片不是占位符,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder Type()
返回图片的占位符类型;如果形状不是占位符,则返回 Placeholder
。
返回
Placeholder
- 此图片的占位符类型。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Rotation()
返回元素围绕其中心顺时针旋转的角度(以度为单位),其中 0 度表示不旋转。
返回
Number
- 旋转角度(以度为单位),介于 0(包括)和 360(不包括)之间。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Source Url()
获取图片的来源网址(如果有)。
通过网址插入图片时,返回插入图片时提供的网址。
返回
String
- 图片网址;如果图片没有来源网址,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Title()
返回网页元素的替代文本标题。标题会与说明结合使用,以显示和朗读替代文本。
返回
String
- 网页元素的替代文本标题。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Top()
获取元素的垂直位置(以像素为单位),从页面左上角测量,前提是元素未旋转。
返回
Number
- 此元素的垂直位置(以点为单位),相对于页面左上角。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Transform()
返回页面元素的转换。
页面元素的外观取决于其绝对转换。如需计算绝对转换,请预先将网页元素的转换与其所有父级组的转换串联起来。如果页面元素不在组中,则其绝对转换与此字段中的值相同。
返回
Affine
- 网页元素的转换。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Width()
返回元素的宽度(以像素为单位),即元素未旋转时的边界框宽度。
此方法不适用于所有页面元素。如需了解哪些页面元素不支持此方法,请参阅 调整大小和位置限制。
返回
Number
- 页面元素固有的宽度(以点为单位),如果页面元素没有宽度,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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 | 要预连接到此页面元素的转换的转换。 |
返回
Image
- 此页面元素,用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
移除页面元素。
如果在移除操作后,Group
仅包含一个或没有页面元素,则该组本身也会被移除。
如果从主屏幕或布局中移除占位符 Page
,则所有空的继承占位符也会一并移除。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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(blobSource)
将此图片替换为由 Blob
对象描述的图片。
插入图片会从
Blob
中提取一次,并存储一个副本以在演示文稿中显示。图片大小不得超过 50 MB,不得超过 2500 万像素,且必须为 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);
参数
名称 | 类型 | 说明 |
---|---|---|
blob | Blob | 图片数据。 |
返回
Image
- 更换后的此 Image
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
将此图片替换为由 Image
对象描述的图片,并可选择剪裁图片以适应大小。
插入图片会从
Blob
中提取一次,并存储一个副本以在演示文稿中显示。图片大小不得超过 50 MB,不得超过 2500 万像素,且必须为 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'); // Replace and crop the drive image. image.replace(driveImage, true);
参数
名称 | 类型 | 说明 |
---|---|---|
blob | Blob | 图片数据。 |
crop | Boolean | 如果为 true ,则会剪裁图片以适应现有图片的大小。否则,系统会缩放图片并将其居中显示。 |
返回
Image
- 更换后的此 Image
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl)
将此图片替换为从所提供网址下载的另一张图片。
插入图片会从网址中提取一次图片,并存储一个副本以供在演示文稿中显示。图片大小不得超过 50MB,不得超过 2500 万像素,且必须为 PNG、JPEG 或 GIF 格式。
提供的网址必须可供公开访问,且不得大于 2KB。网址本身会随图片一起保存,并通过 get
公开。
为了保持图片的宽高比,系统会根据现有图片的大小缩放图片并将其居中。
参数
名称 | 类型 | 说明 |
---|---|---|
image | String | 用于下载图片的网址。 |
返回
Image
- 更换后的此 Image
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl, crop)
将此图片替换为从所提供网址下载的另一张图片,并可选择剪裁图片以适应大小。
插入图片会从网址中提取一次图片,并存储一个副本以供在演示文稿中显示。图片大小不得超过 50MB,不得超过 2500 万像素,且必须为 PNG、JPEG 或 GIF 格式。
提供的网址不得大于 2 KB。
参数
名称 | 类型 | 说明 |
---|---|---|
image | String | 用于下载图片的网址。 |
crop | Boolean | 如果为 true ,则会剪裁图片以适应现有图片的大小。否则,系统会缩放图片并将其居中显示。 |
返回
Image
- 更换后的此 Image
。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scale Height(ratio)
根据指定的比例缩放元素的高度。元素的高度是指元素未旋转时的边界框的高度。
此方法不适用于所有页面元素。如需了解哪些页面元素不支持此方法,请参阅 调整大小和位置限制。
参数
名称 | 类型 | 说明 |
---|---|---|
ratio | Number | 用于缩放此页面元素高度的比例。 |
返回
Image
- 此页面元素,用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scale Width(ratio)
按指定的比例缩放元素的宽度。元素的宽度是指元素未旋转时的边界框的宽度。
此方法不适用于所有页面元素。如需了解哪些页面元素不支持此方法,请参阅 调整大小和位置限制。
参数
名称 | 类型 | 说明 |
---|---|---|
ratio | Number | 用于缩放此页面元素宽度的比例。 |
返回
Image
- 此页面元素,用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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();
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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 ,则所选内容会替换之前的所有选择;否则,所选内容会添加到之前的所有选择中。 |
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
send Backward()
send To Back()
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 | 要将替代文本说明设置为的字符串。 |
返回
Image
- 此页面元素。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Height(height)
设置元素的高度(以点为单位),即元素未旋转时的边界框的高度。
此方法不适用于所有页面元素。如需了解哪些页面元素不支持此方法,请参阅 调整大小和位置限制。
参数
名称 | 类型 | 说明 |
---|---|---|
height | Number | 要设置的此页面元素的新高度(以点为单位)。 |
返回
Image
- 此页面元素,用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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 | 幻灯片的索引(从零开始)。 |
返回
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Slide(slide)
将 Link
设置为给定的 Slide
,链接由给定的幻灯片 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 。 |
返回
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link Slide(slidePosition)
// 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 。 |
返回
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Link 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 | 网址字符串。 |
返回
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Rotation(angle)
设置元素围绕其中心顺时针旋转的角度(以度为单位)。
此方法不适用于所有页面元素。如需了解哪些页面元素不支持此方法,请参阅 调整大小和位置限制。
参数
名称 | 类型 | 说明 |
---|---|---|
angle | Number | 要设置的新顺时针旋转角度(以度为单位)。 |
返回
Image
- 此页面元素,用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
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 | 要将替代文本标题设置为的字符串。 |
返回
Image
- 此页面元素。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Top(top)
set Transform(transform)
使用提供的转换设置页面元素的转换。
更新组的转换会更改该组中页面元素的绝对转换,这可能会更改其视觉外观。
更新分组中的页面元素的转换只会更改该页面元素的转换;不会影响该分组或分组中的其他页面元素的转换。
如需详细了解转换对页面元素的外观有何影响,请参阅 get
。
参数
名称 | 类型 | 说明 |
---|---|---|
transform | Affine | 为此页面元素设置的转换。 |
返回
Image
- 此元素,用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Width(width)
设置元素的宽度(以点为单位),即元素未旋转时的边界框的宽度。
此方法不适用于所有页面元素。如需了解哪些页面元素不支持此方法,请参阅 调整大小和位置限制。
参数
名称 | 类型 | 说明 |
---|---|---|
width | Number | 要设置的此页面元素的新宽度(以点为单位)。 |
返回
Image
- 此页面元素,用于链式调用。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations